Uri.ToString-Methode

Gibt eine kanonische Zeichenfolgenentsprechung der angegebenen Uri-Instanz zurück.

Namespace: System
Assembly: System (in system.dll)

Syntax

'Declaration
Public Overrides Function ToString As String
'Usage
Dim instance As Uri
Dim returnValue As String

returnValue = instance.ToString

public override string ToString ()

public:
virtual String^ ToString () override

public String ToString ()

public override function ToString () : String

Rückgabewert

Eine String-Instanz, die eine kanonische Darstellung der Uri-Instanz enthält, die nicht mit Escapezeichen versehen wurde. #, ? und % sind die einzigen Zeichen, die mit Escapezeichen versehen sind.

Hinweise

Die von dieser Methode zurückgegebene Zeichenfolge enthält keine Anschlussinformationen, wenn der Anschluss den Standardanschluss für das Schema darstellt.

Beispiel

Im folgenden Beispiel wird eine neue Uri-Instanz aus einer Zeichenfolge erstellt. Das Beispiel veranschaulicht den Unterschied zwischen dem von OriginalString zurückgegebenen Wert, der die dem Konstruktur übergebene Zeichenfolge zurückgibt, und einem Aufruf von ToString, der die kanonische Form der Zeichenfolge zurückgibt.

    ' Create a new Uri from a string address.
    Dim uriAddress As New Uri("HTTP://www.Contoso.com:80//thick%20and%20thin.htm")
    
    ' Write the new Uri to the console and note the difference in the two values.
    ' ToString() gives the canonical version.  OriginalString gives the orginal 
    ' string that was passed to the constructor.
    ' The following outputs "https://www.contoso.com/thick and thin.htm".
    Console.WriteLine(uriAddress.ToString())
    
    ' The following outputs "HTTP://www.Contoso.com:80//thick%20and%20thin.htm".
    Console.WriteLine(uriAddress.OriginalString)

End Sub 'SampleToString

// Create a new Uri from a string address.
Uri uriAddress = new Uri("HTTP://www.Contoso.com:80//thick%20and%20thin.htm");

// Write the new Uri to the console and note the difference in the two values.
// ToString() gives the canonical version.  OriginalString gives the orginal 
// string that was passed to the constructor.

// The following outputs "https://www.contoso.com/thick and thin.htm".
Console.WriteLine(uriAddress.ToString()); 

// The following outputs "HTTP://www.Contoso.com:80//thick%20and%20thin.htm".
Console.WriteLine(uriAddress.OriginalString);

.NET Framework-Sicherheit

• SecurityPermission  zum Verhindern, dass teilweise vertrauenswürdiger Code von Uri ableitet. Zugeordnete Enumeration: Infrastructure.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Uri-Klasse
Uri-Member
System-Namespace