Uri Construtores

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

public:
 Uri(System::String ^ uriString);

public Uri(string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Parâmetros

Exceções

Exemplos

O exemplo a seguir cria uma Uri instância com o URI http://www.contoso.com/.

Uri myUri = new Uri("http://www.contoso.com/");

let myUri = Uri "http://www.contoso.com/"

Dim myUri As New Uri("http://www.contoso.com/")

Comentários

Esse construtor cria uma Uri instância de uma cadeia de caracteres de URI. Ele analisa o URI, coloca-o em formato canônico e faz as codificações de escape necessárias.

Esse construtor não garante que ele Uri se refira a um recurso acessível.

Se representar uriString um endereço IPv6, ele deverá estar entre colchetes, por exemplo, "http://[2607:f8b0:400d:c06::69]".

Esse construtor pressupõe que o string parâmetro faz referência a um URI absoluto e é equivalente a chamar o Uri construtor com UriKind definido como Absolute. Se o string parâmetro passado para o construtor for um URI relativo, esse construtor gerará um UriFormatException.

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected Uri(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

protected Uri(System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Parâmetros

Atributos

ObsoleteAttribute

Exceções

Comentários

Esse construtor implementa a ISerializable interface da Uri classe.

Confira também

• Serialização XML e SOAP

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

public:
 Uri(System::String ^ uriString, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);

[System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")]
public Uri(string uriString, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(string uriString, bool dontEscape);

public Uri(string uriString, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri

[<System.Obsolete("This constructor has been deprecated. Use Uri(string) instead.")>]
new Uri : string * bool -> Uri

[<System.Obsolete("The constructor has been deprecated. Please use new Uri(string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : string * bool -> Uri

new Uri : string * bool -> Uri

Public Sub New (uriString As String, dontEscape As Boolean)

Parâmetros

Atributos

ObsoleteAttribute

Exceções

Comentários

Esse construtor cria uma Uri instância de uma cadeia de caracteres de URI. Ele analisa o URI e o coloca em formato canônico.

O dontEscape parâmetro controla se os caracteres reservados são convertidos em sequências de escape. Esse parâmetro deve ser definido true apenas se você tiver certeza de que todos os caracteres reservados no URI foram escapados. Definir o valor true para um URI que não foi completamente escapado pode causar um comportamento inesperado. É altamente recomendável que você sempre defina esse parâmetro como false.

Se dontEscape estiver definido como false, o construtor escapará de todos os caracteres reservados verificando se todas as ocorrências de porcentagem (%) são seguidas por uma sequência de escape válida. Se a sequência de caracteres após uma porcentagem não for válida, a porcentagem será substituída por %25.

Esse construtor não garante que ele Uri se refira a um recurso acessível.

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

public:
 Uri(System::String ^ uriString, UriCreationOptions % creationOptions);

public Uri(string uriString, in UriCreationOptions creationOptions);

new Uri : string * UriCreationOptions -> Uri

Public Sub New (uriString As String, ByRef creationOptions As UriCreationOptions)

Parâmetros

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

public:
 Uri(System::String ^ uriString, UriKind uriKind);

public Uri(string uriString, UriKind uriKind);

new Uri : string * UriKind -> Uri

Public Sub New (uriString As String, uriKind As UriKind)

Parâmetros

Exceções

Comentários

URIs relativas e absolutas têm restrições diferentes em seu formato. Por exemplo, um URI relativo não requer um esquema ou uma autoridade. O valor especificado deve uriKind corresponder ao tipo de URI passado.uriString No entanto, se RelativeOrAbsolute for especificado, a cadeia de caracteres de URI poderá ser relativa ou absoluta.

Para uriString, um endereço IPv6 no formulário de cadeia de caracteres deve ser colocado entre colchetes, por exemplo, "http://[2607:f8b0:400d:c06::69]".

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);

public Uri(Uri baseUri, string relativeUri);

public Uri(Uri baseUri, string? relativeUri);

new Uri : Uri * string -> Uri

Public Sub New (baseUri As Uri, relativeUri As String)

Parâmetros

Exceções

Exemplos

O exemplo a seguir cria uma nova instância da Uri classe combinando os URIs http://www.contoso.com relativos e catalog/shownew.htm formando o URI http://www.contoso.com/catalog/shownew.htmabsoluto.

Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());

let baseUri = Uri "http://www.contoso.com"
let myUri = Uri(baseUri, "catalog/shownew.htm")

printfn $"{myUri}"

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "catalog/shownew.htm")

Console.WriteLine(myUri.ToString())

Comentários

Esse construtor cria uma Uri instância combinando o baseUrirelativeUri. Se relativeUri for um URI absoluto (contendo um esquema, um nome de host e, opcionalmente, um número de porta), a Uri instância será criada usando apenas relativeUri.

Se houver baseUri partes relativas (como /api), a parte relativa deverá ser encerrada com uma barra, (como /api/), se a parte relativa for baseUri preservada na construção Uri.

Além disso, se a relativeUri barra começar, ela substituirá qualquer parte relativa da baseUri

Esse construtor não garante que ele Uri se refira a um recurso acessível.

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

public:
 Uri(Uri ^ baseUri, Uri ^ relativeUri);

public Uri(Uri baseUri, Uri relativeUri);

new Uri : Uri * Uri -> Uri

Public Sub New (baseUri As Uri, relativeUri As Uri)

Parâmetros

Exceções

Exemplos

Este exemplo cria uma instância absoluteUriabsoluta Uri e uma instância relativeUrirelativaUri. Uma nova Uri instância, em seguida, combinedUrié criada a partir dessas duas instâncias.

// Create an absolute Uri from a string.
Uri absoluteUri = new Uri("http://www.contoso.com/");

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
Uri relativeUri = new Uri("/catalog/shownew.htm?date=today", UriKind.Relative);

// Check whether the new Uri is absolute or relative.
if (!relativeUri.IsAbsoluteUri)
    Console.WriteLine("{0} is a relative Uri.", relativeUri);

// Create a new Uri from an absolute Uri and a relative Uri.
Uri combinedUri = new Uri(absoluteUri, relativeUri);
Console.WriteLine(combinedUri.AbsoluteUri);

// Create an absolute Uri from a string.
let absoluteUri = Uri "http://www.contoso.com/"

// Create a relative Uri from a string.  allowRelative = true to allow for
// creating a relative Uri.
let relativeUri = Uri("/catalog/shownew.htm?date=today", UriKind.Relative)

// Check whether the new Uri is absolute or relative.
if not relativeUri.IsAbsoluteUri then
    printfn $"{relativeUri} is a relative Uri."

// Create a new Uri from an absolute Uri and a relative Uri.
let combinedUri = Uri(absoluteUri, relativeUri)
printfn $"{combinedUri.AbsoluteUri}"

    ' Create an absolute Uri from a string.
    Dim absoluteUri As New Uri("http://www.contoso.com/")
    
    ' Create a relative Uri from a string.  allowRelative = true to allow for 
    ' creating a relative Uri.
    Dim relativeUri As New Uri("/catalog/shownew.htm?date=today")
    
    ' Check whether the new Uri is absolute or relative.
    If Not relativeUri.IsAbsoluteUri Then
        Console.WriteLine("{0} is a relative Uri.", relativeUri)
    End If 
    ' Create a new Uri from an absolute Uri and a relative Uri.
    Dim combinedUri As New Uri(absoluteUri, relativeUri)
    Console.WriteLine(combinedUri.AbsoluteUri)

End Sub

Comentários

Esse construtor cria uma nova Uri instância combinando uma instância absolutaUri, baseUricom uma instância relativaUri. relativeUri Se relativeUri for uma instância absoluta Uri (contendo um esquema, um nome de host e, opcionalmente, um número de porta), a Uri instância será criada usando apenas relativeUri.

Se houver baseUri partes relativas (como /api), a parte relativa deverá ser encerrada com uma barra, (como /api/), se a parte relativa for baseUri preservada na construção Uri.

Além disso, se começar relativeUri com uma barra, ela substituirá qualquer parte relativa do baseUri.

Esse construtor não garante que ele Uri se refira a um recurso acessível.

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

Origem:

Uri.cs

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri, bool dontEscape);

[System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string? relativeUri, bool dontEscape);

[System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string relativeUri, bool dontEscape);

public Uri(Uri baseUri, string relativeUri, bool dontEscape);

[<System.Obsolete("This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri

[<System.Obsolete("This constructor has been deprecated. Use Uri(Uri, string) instead.")>]
new Uri : Uri * string * bool -> Uri

[<System.Obsolete("The constructor has been deprecated. Please new Uri(Uri, string). The dontEscape parameter is deprecated and is always false. https://go.microsoft.com/fwlink/?linkid=14202")>]
new Uri : Uri * string * bool -> Uri

new Uri : Uri * string * bool -> Uri

Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Parâmetros

Atributos

ObsoleteAttribute

Exceções

Comentários

Esse construtor cria uma Uri instância combinando baseUri e relativeUri. Se o URI passado relativeUri for um URI absoluto (contendo um esquema, um nome de host e, opcionalmente, um número de porta), a Uri instância será criada usando apenas relativeUri.

O dontEscape parâmetro controla se os caracteres reservados são convertidos em sequências de escape. Esse parâmetro deve ser definido true apenas se você tiver certeza de que todos os caracteres reservados no URI foram escapados. Definir o valor true para um URI que não foi completamente escapado pode causar um comportamento inesperado. É altamente recomendável que você sempre defina esse parâmetro como false. Se dontEscape estiver definido como false, o construtor escapará de todos os caracteres reservados verificando se todas as ocorrências de porcentagem (%) são seguidas por uma sequência de escape válida. Se a sequência de caracteres após uma porcentagem não for válida, a porcentagem será substituída por %25.

Esse construtor não garante que ele Uri se refira a um recurso acessível.

Notas aos Chamadores

Devido a problemas de segurança, seu aplicativo não deve chamar esse construtor com cadeias de caracteres de URI de fontes não confiáveis e com dontEscape definido como true. Como alternativa, você pode verificar a validade de uma cadeia de caracteres de URI chamando o IsWellFormedOriginalString() método antes de chamar esse construtor.