Path Klass

Definition

public ref class Path abstract sealed

public ref class Path sealed

public static class Path

public sealed class Path

[System.Runtime.InteropServices.ComVisible(true)]
public static class Path

type Path = class

[<System.Runtime.InteropServices.ComVisible(true)>]
type Path = class

Public Class Path

Public NotInheritable Class Path

Arv

Object

Path

Attribut

ComVisibleAttribute

Exempel

I följande exempel visas några av de viktigaste medlemmarna i Path klassen.

using System;
using System.IO;

class Test
{
    
    public static void Main()
    {
        string path1 = @"c:\temp\MyTest.txt";
        string path2 = @"c:\temp\MyTest";
        string path3 = @"temp";

        if (Path.HasExtension(path1))
        {
            Console.WriteLine("{0} has an extension.", path1);
        }

        if (!Path.HasExtension(path2))
        {
            Console.WriteLine("{0} has no extension.", path2);
        }

        if (!Path.IsPathRooted(path3))
        {
            Console.WriteLine("The string {0} contains no root information.", path3);
        }

        Console.WriteLine("The full path of {0} is {1}.", path3, Path.GetFullPath(path3));
        Console.WriteLine("{0} is the location for temporary files.", Path.GetTempPath());
        Console.WriteLine("{0} is a file available for use.", Path.GetTempFileName());

        /* This code produces output similar to the following:
         * c:\temp\MyTest.txt has an extension.
         * c:\temp\MyTest has no extension.
         * The string temp contains no root information.
         * The full path of temp is D:\Documents and Settings\cliffc\My Documents\Visual Studio 2005\Projects\ConsoleApplication2\ConsoleApplication2\bin\Debug\temp.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\ is the location for temporary files.
         * D:\Documents and Settings\cliffc\Local Settings\Temp\8\tmp3D.tmp is a file available for use.
         */
    }
}

Imports System.IO

Public Class Test

    Public Shared Sub Main()
        Dim path1 As String = "c:\temp\MyTest.txt"
        Dim path2 As String = "c:\temp\MyTest"
        Dim path3 As String = "temp"

        If Path.HasExtension(path1) Then
            Console.WriteLine("{0} has an extension.", path1)
        End If

        If Path.HasExtension(path2) = False Then
            Console.WriteLine("{0} has no extension.", path2)
        End If

        If Path.IsPathRooted(path3) = False Then
            Console.WriteLine("The string {0} contains no root information.", path3)
        End If

        Console.WriteLine("The full path of {0} is {1}.", path3, Path.GetFullPath(path3))
        Console.WriteLine("{0} is the location for temporary files.", Path.GetTempPath())
        Console.WriteLine("{0} is a file available for use.", Path.GetTempFileName())

        ' This code produces output similar to the following:
        ' c:\temp\MyTest.txt has an extension.
        ' c:\temp\MyTest has no extension.
        ' The string temp contains no root information.
        ' The full path of temp is D:\Documents and Settings\cliffc\My Documents\Visual Studio 2005\Projects\ConsoleApplication2\ConsoleApplication2\bin\Debug\temp.
        ' D:\Documents and Settings\cliffc\Local Settings\Temp\8\ is the location for temporary files.
        ' D:\Documents and Settings\cliffc\Local Settings\Temp\8\tmp3D.tmp is a file available for use.

    End Sub
End Class

Kommentarer

En sökväg är en sträng som tillhandahåller platsen för en fil eller katalog. En sökväg pekar inte nödvändigtvis på en plats på disken. En sökväg kan till exempel mappas till en plats i minnet eller på en enhet. Det exakta formatet för en sökväg bestäms av den aktuella plattformen. I vissa system kan till exempel en sökväg börja med en enhets- eller volymbeteckning, medan det här elementet inte finns i andra system. I vissa system kan filsökvägar innehålla tillägg, vilket anger vilken typ av information som lagras i filen. Formatet för filnamnstillägget är plattformsberoende. Vissa system begränsar till exempel tillägg till tre tecken (till exempel FAT16 som ofta används på mindre flashlagring och äldre versioner av ISO 9660 som används på optiska medier), och andra inte. Den aktuella plattformen avgör också vilken uppsättning tecken som används för att avgränsa elementen i en sökväg och den uppsättning tecken som inte kan användas när du anger sökvägar. På grund av dessa skillnader är fälten i Path klassen samt det exakta beteendet för vissa medlemmar i Path klassen plattformsberoende.

En sökväg kan innehålla absolut eller relativ platsinformation. Absoluta sökvägar anger helt en plats: filen eller katalogen kan identifieras unikt oavsett den aktuella platsen. Relativa sökvägar anger en partiell plats: den aktuella platsen används som startpunkt när en fil som anges med en relativ sökväg hittas. Om du vill fastställa den aktuella katalogen anropar du Directory.GetCurrentDirectory.

Den här typen stöder också åtkomst till filsystemobjekt som är enhetsnamn, till exempel "\\?\C:\". Stöd för enhetsnamn lades till i .NET Framework 4.6.2.

Mer information om filsökvägsformat på Windows finns i sökvägsformaten File på Windows system.

De flesta medlemmar i Path klassen interagerar inte med filsystemet och kontrollerar inte förekomsten av filen som anges av en sökvägssträng. Path klassmedlemmar som ändrar en sökvägssträng, till exempel ChangeExtension, har ingen effekt på namn på filer i filsystemet.

Vissa Path medlemmar verifierar innehållet i en angiven sökvägssträng och genererar ett ArgumentException om strängen innehåller tecken som inte är giltiga i sökvägssträngar, enligt definitionen i de tecken som returneras från GetInvalidPathChars metoden. På Windows-baserade skrivbordsplattformar kan ogiltiga sökvägstecken till exempel innehålla citattecken ("), mindre än (<), större än (>), pipe (|), backspace (\b), null (\0) och Unicode-tecken 16 till 18 och 20 till och med 25. Det här valideringsbeteendet varierar mellan .NET versioner:

• På .NET Framework: Alla Path medlemmar som tar en sökväg som ett argument genererar en ArgumentException om de identifierar ogiltiga sökvägstecken.

• På .NET: GetFullPath är den enda medlemmen som genererar en ArgumentException om strängen innehåller ogiltiga sökvägstecken.

Med klassens Path medlemmar kan du snabbt och enkelt utföra vanliga åtgärder som att avgöra om ett filnamnstillägg är en del av en sökväg och kombinera två strängar till ett sökvägsnamn.

Alla medlemmar i Path klassen är statiska och kan därför anropas utan att ha en instans av en sökväg.

I medlemmar som accepterar en sökväg kan sökvägen referera till en fil eller bara en katalog. Den angivna sökvägen kan också referera till en relativ sökväg eller en UNC-sökväg (Universal Naming Convention) för en server och ett resursnamn. Till exempel är alla följande godkända sökvägar:

• "c:\\MyDir\\MyFile.txt" i C#, eller "c:\MyDir\MyFile.txt" i Visual Basic.

• "c:\\MyDir" i C#, eller "c:\MyDir" i Visual Basic.

• "MyDir\\MySubdir" i C#, eller "MyDir\MySubDir" i Visual Basic.

• "\\\\MyServer\\MyShare" i C#, eller "\\MyServer\MyShare" i Visual Basic.

Eftersom alla dessa åtgärder utförs på strängar är det omöjligt att verifiera att resultaten är giltiga i alla scenarier. Metoden parsar till exempel GetExtension en sträng som du skickar till den och returnerar tillägget från strängen. Detta innebär dock inte att det finns en fil med tillägget på disken.

En lista över vanliga I/O-uppgifter finns i Vanliga I/O-uppgifter.

Se även

• Fil- och ström-I/O
• Anvisningar: Läsa text från en fil
• Anvisningar: Skriva text till en fil
• Anvisningar: Läsa och skriva till en nyligen skapad datafil
• File-sökvägsformat i Windows system