Path.IsPathRooted Metode

Definisi

Ruang nama:

System.IO

Rakitan:

System.Runtime.dll

Mengembalikan nilai yang menunjukkan apakah jalur file berisi akar.

Overload

IsPathRooted(String)	Mengembalikan nilai yang menunjukkan apakah string jalur yang ditentukan berisi akar.
IsPathRooted(ReadOnlySpan<Char>)	Mengembalikan nilai yang menunjukkan apakah rentang karakter yang ditentukan yang mewakili jalur file berisi akar.

Keterangan

Jalur berakar adalah jalur file yang diperbaiki ke drive atau jalur UNC tertentu; kontras dengan jalur yang relatif terhadap drive atau direktori kerja saat ini. Misalnya, pada sistem Windows, jalur berakar dimulai dengan garis miring terbalik (misalnya, "\Documents") atau huruf kandar dan titik dua (misalnya, "C:Documents").

Perhatikan bahwa jalur berakar dapat bersifat absolut (yaitu, sepenuhnya memenuhi syarat) atau relatif. Jalur berakar absolut adalah jalur yang sepenuhnya memenuhi syarat dari akar drive ke direktori tertentu. Jalur berakar relatif menentukan drive, tetapi jalurnya yang sepenuhnya memenuhi syarat diselesaikan terhadap direktori saat ini. Contoh berikut mengilustrasikan perbedaannya.

using System;
using System.IO;

class Program
{
    static void Main()
    {
        string relative1 = "C:Documents"; 
        ShowPathInfo(relative1);

        string relative2 = "/Documents";
        ShowPathInfo(relative2);

        string absolute = "C:/Documents";
        ShowPathInfo(absolute);
    }

    private static void ShowPathInfo(string path)
    {
        Console.WriteLine($"Path: {path}");
        Console.WriteLine($"   Rooted: {Path.IsPathRooted(path)}");
        Console.WriteLine($"   Fully qualified: {Path.IsPathFullyQualified(path)}");
        Console.WriteLine($"   Full path: {Path.GetFullPath(path)}");
        Console.WriteLine();
    }
}
// The example displays the following output when run on a Windows system:
//    Path: C:Documents
//        Rooted: True
//        Fully qualified: False
//        Full path: c:\Users\user1\Documents\projects\path\ispathrooted\Documents
//
//    Path: /Documents
//       Rooted: True
//       Fully qualified: False
//       Full path: c:\Documents
//
//    Path: C:/Documents
//       Rooted: True
//       Fully qualified: True
//       Full path: C:\Documents

Imports System.IO

Module Program
    Public Sub Main()
        Dim relative1 As String = "C:Documents" 
        ShowPathInfo(relative1)

        Dim relative2 As String = "C:Documents" 
        ShowPathInfo(relative2)

        Dim absolute As String = "C:/Documents"
        ShowPathInfo(absolute)
    End Sub

    Private Sub ShowPathInfo(filepath As String)
        Console.WriteLine($"Path: {filepath}")
        Console.WriteLine($"   Rooted: {Path.IsPathRooted(filepath)}")
        Console.WriteLine($"   Fully qualified: {Path.IsPathFullyQualified(filepath)}")
        Console.WriteLine($"   Full path: {Path.GetFullPath(filepath)}")
        Console.WriteLine()
    End Sub
End Module
' The example displays the following output when run on a Windows system:
'    Path: C:Documents
'        Rooted: True
'        Fully qualified: False
'        Full path: c:\Users\user1\Documents\projects\path\ispathrooted\Documents
'
'    Path: /Documents
'       Rooted: True
'       Fully qualified: False
'       Full path: c:\Documents
'
'    Path: C:/Documents
'       Rooted: True
'       Fully qualified: True
'       Full path: C:\Documents

IsPathRooted(String)

Sumber:

Path.Unix.cs

Mengembalikan nilai yang menunjukkan apakah string jalur yang ditentukan berisi akar.

public:
 static bool IsPathRooted(System::String ^ path);

public static bool IsPathRooted (string? path);

static member IsPathRooted : string -> bool

Public Shared Function IsPathRooted (path As String) As Boolean

Parameter

path

String

Jalur untuk diuji.

Mengembalikan

Boolean

true jika path berisi akar; jika tidak, false.

Pengecualian

ArgumentException

versi .NET Framework dan .NET Core yang lebih lama dari 2.1: path berisi satu atau beberapa karakter yang tidak valid yang ditentukan dalam GetInvalidPathChars().

Contoh

Contoh berikut menunjukkan bagaimana IsPathRooted metode dapat digunakan untuk menguji tiga string.

String^ fileName = "C:\\mydir\\myfile.ext";
String^ UncPath = "\\\\myPc\\mydir\\myfile";
String^ relativePath = "mydir\\sudir\\";
bool result;
result = Path::IsPathRooted( fileName );
Console::WriteLine( "IsPathRooted('{0}') returns {1}", fileName, result.ToString() );
result = Path::IsPathRooted( UncPath );
Console::WriteLine( "IsPathRooted('{0}') returns {1}", UncPath, result.ToString() );
result = Path::IsPathRooted( relativePath );
Console::WriteLine( "IsPathRooted('{0}') returns {1}", relativePath, result.ToString() );

// This code produces output similar to the following:
//
// IsPathRooted('C:\mydir\myfile.ext') returns True
// IsPathRooted('\\myPc\mydir\myfile') returns True
// IsPathRooted('mydir\sudir\') returns False

string fileName = @"C:\mydir\myfile.ext";
string UncPath = @"\\myPc\mydir\myfile";
string relativePath = @"mydir\sudir\";
bool result;

result = Path.IsPathRooted(fileName);
Console.WriteLine("IsPathRooted('{0}') returns {1}",
    fileName, result);

result = Path.IsPathRooted(UncPath);
Console.WriteLine("IsPathRooted('{0}') returns {1}",
    UncPath, result);

result = Path.IsPathRooted(relativePath);
Console.WriteLine("IsPathRooted('{0}') returns {1}",
    relativePath, result);

// This code produces output similar to the following:
//
// IsPathRooted('C:\mydir\myfile.ext') returns True
// IsPathRooted('\\myPc\mydir\myfile') returns True
// IsPathRooted('mydir\sudir\') returns False

Dim fileName As String = "C:\mydir\myfile.ext"
Dim UncPath As String = "\\myPc\mydir\myfile"
Dim relativePath As String = "mydir\sudir\"
Dim result As Boolean

result = Path.IsPathRooted(fileName)
Console.WriteLine("IsPathRooted('{0}') returns {1}", fileName, result)

result = Path.IsPathRooted(UncPath)
Console.WriteLine("IsPathRooted('{0}') returns {1}", UncPath, result)

result = Path.IsPathRooted(relativePath)
Console.WriteLine("IsPathRooted('{0}') returns {1}", relativePath, result)

' This code produces output similar to the following:
'
' IsPathRooted('C:\mydir\myfile.ext') returns True
' IsPathRooted('\\myPc\mydir\myfile') returns True
' IsPathRooted('mydir\sudir\') returns False

Keterangan

Metode IsPathRooted mengembalikan true jika karakter pertama adalah karakter pemisah direktori seperti "\", atau jika jalur dimulai dengan huruf drive dan titik dua (:). Misalnya, menampilkan true untuk path string seperti "\\MyDir\MyFile.txt", "C:\MyDir", atau "C:MyDir". Ini mengembalikan false untuk path string seperti "MyDir".

Metode ini tidak memverifikasi bahwa jalur atau nama file ada.

Untuk daftar tugas I/O umum, lihat Tugas I/O Umum.

Lihat juga

• Format jalur file pada sistem Windows
• I/O File dan Aliran
• Cara: Membaca Teks dari File
• Cara: Menulis Teks ke File

IsPathRooted(ReadOnlySpan<Char>)

Sumber:

Path.Unix.cs

Mengembalikan nilai yang menunjukkan apakah rentang karakter yang ditentukan yang mewakili jalur file berisi akar.

public:
 static bool IsPathRooted(ReadOnlySpan<char> path);

public static bool IsPathRooted (ReadOnlySpan<char> path);

static member IsPathRooted : ReadOnlySpan<char> -> bool

Public Shared Function IsPathRooted (path As ReadOnlySpan(Of Char)) As Boolean

Parameter

path

ReadOnlySpan<Char>

Jalur untuk diuji.

Mengembalikan

Boolean

true jika path berisi akar; jika tidak, false.

Lihat juga

• Format jalur file pada sistem Windows