Uri.ToString Uri.ToString Uri.ToString Uri.ToString Method

Definition

Ruft eine kanonische Zeichenfolgenentsprechung der angegebenen Uri-Instanz ab.Gets a canonical string representation for the specified Uri instance.

public:
 override System::String ^ ToString();
public override string ToString ();
override this.ToString : unit -> string
Public Overrides Function ToString () As String

Gibt zurück

Eine String-Instanz, die eine kanonische Darstellung der Uri-Instanz enthält, die nicht mit Escapezeichen versehen wurde.A String instance that contains the unescaped canonical representation of the Uri instance. #, ? und % sind die einzigen Zeichen, die mit Escapezeichen versehen sind.All characters are unescaped except #, ?, and %.

Beispiele

Das folgende Beispiel erstellt ein neues Uri Instanz aus einer Zeichenfolge.The following example creates a new Uri instance from a string. Veranschaulicht den Unterschied zwischen den Rückgabewert aus OriginalString, womit die Zeichenfolge, die übergeben wurde, an den Konstruktor, und von einem Aufruf von ToString, die die kanonische Form der Zeichenfolge zurückgibt.It illustrates the difference between the value returned from OriginalString, which returns the string that was passed to the constructor, and from a call to ToString, which returns the canonical form of the string.

// Create a new Uri from a string address.
Uri^ uriAddress = gcnew 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 "http://www.contoso.com/thick and thin.htm".
Console::WriteLine( uriAddress );

// The following outputs "HTTP://www.Contoso.com:80/thick%20and%20thin.htm".
Console::WriteLine( uriAddress->OriginalString );
// 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 "http://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);
    ' 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 "http://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

Hinweise

Die von dieser Methode zurückgegebene Zeichenfolge enthält keine Portinformationen, wenn der Port der Standardport für das Schema ist.The string returned by this method does not contain port information when the port is the default port for the scheme.

Hinweis

Die zurückgegebene Zeichenfolge den ToString Methode darf die Steuerzeichen, die den Zustand einer Konsolenanwendung beschädigt werden können.The string returned by the ToString method may contain control characters, which can corrupt the state of a console application. Können Sie die GetComponents -Methode mit dem UriFormat.SafeUnescaped Format Steuerzeichen aus der zurückgegebenen Zeichenfolge zu entfernen.You can use the GetComponents method with the UriFormat.SafeUnescaped format to remove control characters from the returned string.

Sicherheit

SecurityPermission
um zu verhindern, dass teilweise vertrauenswürdigen Code Ableiten von Uri.to prevent partially trusted code from deriving from Uri. Zugeordnete Enumeration: InfrastructureAssociated enumeration: Infrastructure.

Gilt für: