Uri.OriginalString Propiedad

Definición

Obtiene la cadena de identificador URI original que se pasó al constructor Uri.Gets the original URI string that was passed to the Uri constructor.

public:
 property System::String ^ OriginalString { System::String ^ get(); };
public string OriginalString { get; }
member this.OriginalString : string
Public ReadOnly Property OriginalString As String

Valor de propiedad

String

El URI exacto que se especificó cuando se construyó esta instancia; en caso contrario, Empty .The exact URI specified when this instance was constructed; otherwise, Empty.

Ejemplos

En el ejemplo siguiente se crea una nueva Uri instancia de a partir de una cadena.The following example creates a new Uri instance from a string. Muestra la diferencia entre el valor devuelto de OriginalString , que devuelve la cadena que se pasó al constructor y de una llamada a ToString , que devuelve la forma canónica de la cadena.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 original 
// 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 original
// 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 original 
    ' 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

Comentarios

Si el URI especificado para el constructor contenía espacios iniciales o finales, se conservan estos espacios.If the URI specified to the constructor contained leading or trailing spaces, these spaces are preserved.

El valor devuelto por esta propiedad difiere de ToString y AbsoluteUri .The value returned by this property differs from ToString and AbsoluteUri. ToString Devuelve la forma canónicamente sin escape del identificador URI.ToString returns the canonically unescaped form of the URI. AbsoluteUri Devuelve el formato de escape canónico del identificador URI.AbsoluteUri returns the canonically escaped form of the URI.

Cuando se habilita la compatibilidad con el identificador de recursos internacionales (IRI) y el nombre de dominio internacionalizado (IDN), OriginalString devuelve la cadena no normalizada original con el nombre de host Punycode si se usó uno para inicializar la Uri instancia.When International Resource Identifier (IRI) and Internationalized Domain Name (IDN) support are enabled, OriginalString returns the original non normalized string with Punycode host name if one was used to initialize the Uri instance. Los nombres de Punycode solo contienen caracteres ASCII y siempre empiezan con el prefijo xn--.Punycode names contain only ASCII characters and always start with the xn-- prefix.

Para obtener más información sobre la compatibilidad con IRI, consulte la sección Comentarios de la Uri clase.For more information on IRI support, see the Remarks section for the Uri class.

Cuando Uri se serializa un objeto, OriginalString no se conserva.When a Uri object is serialized, the OriginalString is not preserved. El proceso de serialización utiliza la propiedad totalmente con escape y con formato canónico AbsoluteUri al serializar.The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. UriEn el caso de que contenga una dirección IPv6, la dirección IPv6 y el identificador de ámbito se incluyen en el objeto serializado Uri .For a Uri that contains an IPv6 address, the IPv6 address and the scope ID are included in the serialized Uri object.

Se aplica a