Uri.OriginalString Uri.OriginalString Uri.OriginalString Uri.OriginalString Property

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 que contiene el identificador URI exacto que se especificó al construir esta instancia; en caso contrario, Empty.A String containing the exact URI specified when this instance was constructed; otherwise, Empty.

Ejemplos

En el ejemplo siguiente se crea una nueva instancia de Uri 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 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

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 el formato canónico sin escape del 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 original no normalizada con el nombre de host Punycode si se usó una para inicializar la instancia de Uri.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 clase Uri.For more information on IRI support, see the Remarks section for the Uri class.

Cuando se serializa un objeto Uri, no se conserva el OriginalString.When a Uri object is serialized, the OriginalString is not preserved. El proceso de serialización utiliza la propiedad AbsoluteUri con escape completo y con formato canónico al serializar.The serialization process uses the fully escaped and canonicalized AbsoluteUri property when serializing. En el caso de una Uri que contiene una dirección IPv6, la dirección IPv6 y el identificador de ámbito se incluyen en el objeto Uri serializado.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