Uri Uri Uri Uri Constructors

Definição

Sobrecargas

Uri(String) Uri(String) Uri(String) Uri(String)

Inicializa uma nova instância da classe Uri com URI especificado.Initializes a new instance of the Uri class with the specified URI.

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe Uri das instâncias especificadas das classes SerializationInfo e StreamingContext.Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

Inicializa uma nova instância da classe Uri com o URI especificado, com controle explícito de escape de caractere.Initializes a new instance of the Uri class with the specified URI, with explicit control of character escaping.

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

Inicializa uma nova instância da classe Uri com URI especificado.Initializes a new instance of the Uri class with the specified URI. Este construtor permite que você especifique se a cadeia de caracteres do URI é um URI relativo, um URI absoluto ou indeterminado.This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate.

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

Inicializa uma nova instância da classe Uri com base no URI base especificado e na cadeia de caracteres do URI relativo.Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Inicializa uma nova instância da classe Uri com base na combinação de uma instância base de Uri especificada e uma instância de Uri relativa.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

Inicializa uma nova instância da classe Uri baseada nos URIs de base e relativos especificados, com controle explícito de escape de caracteres.Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

Uri(String) Uri(String) Uri(String) Uri(String)

Inicializa uma nova instância da classe Uri com URI especificado.Initializes a new instance of the Uri class with the specified URI.

public:
 Uri(System::String ^ uriString);
public Uri (string uriString);
new Uri : string -> Uri
Public Sub New (uriString As String)

Parâmetros

uriString
String String String String

Uma cadeia de caracteres que identifica o recurso a ser representado pela instância de Uri.A string that identifies the resource to be represented by the Uri instance. Observe que um endereço IPv6 no formato de cadeia de caracteres deve estar entre colchetes.Note that an IPv6 address in string form must be enclosed within brackets. Por exemplo, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

Exceções

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString está vazio. uriString is empty.

- ou --or- O esquema especificado em uriString não está formado corretamente.The scheme specified in uriString is not correctly formed. Consulte CheckSchemeName(String).See CheckSchemeName(String).

- ou --or- uriString contém muitas barras “/”.uriString contains too many slashes.

- ou --or- A senha especificada em uriString não é válida.The password specified in uriString is not valid.

- ou --or- O nome do host especificado em uriString não é válido.The host name specified in uriString is not valid.

- ou --or- O nome de arquivo especificado em uriString não é válido.The file name specified in uriString is not valid.

- ou --or- O nome de usuário especificado em uriString não é válido.The user name specified in uriString is not valid.

- ou --or- O nome do host ou da autoridade especificado no uriString não pode terminar em barras invertidas.The host or authority name specified in uriString cannot be terminated by backslashes.

- ou --or- O número da porta especificado em uriString não é válido ou não pode ser analisado.The port number specified in uriString is not valid or cannot be parsed.

- ou --or- O comprimento de uriString excede 65.519 caracteres.The length of uriString exceeds 65519 characters.

- ou --or- O comprimento do esquema especificado no uriString excede 1.023 caracteres.The length of the scheme specified in uriString exceeds 1023 characters.

- ou --or- Há uma sequência de caracteres inválida em uriString.There is an invalid character sequence in uriString.

- ou --or- O caminho do MS-DOS especificado em uriString deve começar com c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemplos

O exemplo a seguir cria Uri uma instância com o http://www.contoso.com/URI.The following example creates a Uri instance with the URI http://www.contoso.com/.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri myUri = new 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.This constructor creates a Uri instance from a URI string. Ele analisa o URI, coloca-o em formato canônico e faz quaisquer codificações de escape necessárias.It parses the URI, puts it in canonical format, and makes any required escape encodings.

Este construtor não garante que o Uri faça referência a um recurso acessível.This constructor does not ensure that the Uri refers to an accessible resource.

Esse construtor assume que o string parâmetro faz referência a um URI absoluto e é equivalente a Uri chamar o UriKind Construtor com Absolutedefinido como.This constructor assumes that the string parameter references an absolute URI and is equivalent to calling the Uri constructor with UriKind set to Absolute. Se o string parâmetro passado para o Construtor for um URI relativo, esse construtor gerará um UriFormatException.If the string parameter passed to the constructor is a relative URI, this constructor will throw a UriFormatException.

Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext) Uri(SerializationInfo, StreamingContext)

Inicializa uma nova instância da classe Uri das instâncias especificadas das classes SerializationInfo e StreamingContext.Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

protected:
 Uri(System::Runtime::Serialization::SerializationInfo ^ serializationInfo, System::Runtime::Serialization::StreamingContext streamingContext);
protected Uri (System.Runtime.Serialization.SerializationInfo serializationInfo, System.Runtime.Serialization.StreamingContext streamingContext);
new Uri : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> Uri

Parâmetros

serializationInfo
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

Uma instância da classe SerializationInfo que contém as informações necessárias para serializar a nova instância de Uri.An instance of the SerializationInfo class containing the information required to serialize the new Uri instance.

streamingContext
StreamingContext StreamingContext StreamingContext StreamingContext

Uma instância da classe StreamingContext que contém a origem do fluxo serializado associado à nova instância de Uri.An instance of the StreamingContext class containing the source of the serialized stream associated with the new Uri instance.

Exceções

O parâmetro serializationInfo contém um URI null.The serializationInfo parameter contains a null URI.

O parâmetro serializationInfo contém um URI vazio.The serializationInfo parameter contains a URI that is empty.

- ou --or- O esquema especificado não está formado corretamente.The scheme specified is not correctly formed. Consulte CheckSchemeName(String).See CheckSchemeName(String).

- ou --or- O URI contém muitas barras.The URI contains too many slashes.

- ou --or- A senha especificada no URI não é válida.The password specified in the URI is not valid.

- ou --or- O nome do host especificado no URI não é válido.The host name specified in URI is not valid.

- ou --or- O nome do arquivo especificado no URI não é válido.The file name specified in the URI is not valid.

- ou --or- O nome de usuário especificado no URI não é válido.The user name specified in the URI is not valid.

- ou --or- O nome do host ou da autoridade especificado no URI não pode terminar em barras invertidas.The host or authority name specified in the URI cannot be terminated by backslashes.

- ou --or- O número da porta especificado no URI não é válido ou não pode ser analisado.The port number specified in the URI is not valid or cannot be parsed.

- ou --or- O tamanho do URI excede 65519 caracteres.The length of URI exceeds 65519 characters.

- ou --or- O tamanho do esquema especificado no URI excede 1023 caracteres.The length of the scheme specified in the URI exceeds 1023 characters.

- ou --or- Há uma cadeia de caracteres inválida no URI.There is an invalid character sequence in the URI.

- ou --or- O caminho do MS-DOS especificado no URI deve começar com c:\\.The MS-DOS path specified in the URI must start with c:\\.

Comentários

Esse construtor implementa a ISerializable interface para a Uri classe.This constructor implements the ISerializable interface for the Uri class.

Veja também

Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean) Uri(String, Boolean)

Aviso

Esta API agora é obsoleta.

Inicializa uma nova instância da classe Uri com o URI especificado, com controle explícito de escape de caractere.Initializes a new instance of the Uri class with the specified URI, with explicit control of character escaping.

public:
 Uri(System::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. http://go.microsoft.com/fwlink/?linkid=14202")]
[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);
new Uri : string * bool -> Uri
Public Sub New (uriString As String, dontEscape As Boolean)

Parâmetros

uriString
String String String String

Uma cadeia de caracteres que identifica o recurso a ser representado pela instância de Uri.A string that identifies the resource to be represented by the Uri instance. Observe que um endereço IPv6 no formato de cadeia de caracteres deve estar entre colchetes.Note that an IPv6 address in string form must be enclosed within brackets. Por exemplo, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

dontEscape
Boolean Boolean Boolean Boolean

true se uriString tiver escape completo; caso contrário, false.true if uriString is completely escaped; otherwise, false.

Exceções

A uriString está vazia ou contém apenas espaços.uriString is empty or contains only spaces.

- ou --or- O esquema especificado em uriString não é válido.The scheme specified in uriString is not valid.

- ou --or- uriString contém muitas barras “/”.uriString contains too many slashes.

- ou --or- A senha especificada em uriString não é válida.The password specified in uriString is not valid.

- ou --or- O nome do host especificado em uriString não é válido.The host name specified in uriString is not valid.

- ou --or- O nome de arquivo especificado em uriString não é válido.The file name specified in uriString is not valid.

- ou --or- O nome de usuário especificado em uriString não é válido.The user name specified in uriString is not valid.

- ou --or- O nome do host ou da autoridade especificado no uriString não pode terminar em barras invertidas.The host or authority name specified in uriString cannot be terminated by backslashes.

- ou --or- O número da porta especificado em uriString não é válido ou não pode ser analisado.The port number specified in uriString is not valid or cannot be parsed.

- ou --or- O comprimento de uriString excede 65.519 caracteres.The length of uriString exceeds 65519 characters.

- ou --or- O comprimento do esquema especificado no uriString excede 1.023 caracteres.The length of the scheme specified in uriString exceeds 1023 characters.

- ou --or- Há uma sequência de caracteres inválida em uriString.There is an invalid character sequence in uriString.

- ou --or- O caminho do MS-DOS especificado em uriString deve começar com c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemplos

O exemplo a seguir cria Uri uma instância para o http://www.contoso.com/Hello%20World.htmURI.The following example creates a Uri instance for the URI http://www.contoso.com/Hello%20World.htm. Como o URI contido está completamente com escape e está na forma canônica, dontEscape o parâmetro pode ser definido truecomo.Because the contained URI is completely escaped and is in canonical form, the dontEscape parameter can be set to true.

Uri^ myUri = gcnew Uri(  "http://www.contoso.com/Hello%20World.htm",true );
Uri myUri = new Uri("http://www.contoso.com/Hello%20World.htm", true);

Dim myUri As New Uri("http://www.contoso.com/Hello%20World.htm", True)

Comentários

Esse construtor cria uma Uri instância de uma cadeia de caracteres de URI.This constructor creates a Uri instance from a URI string. Ele analisa o URI e o coloca em formato canônico.It parses the URI and puts it in canonical format.

O dontEscape parâmetro controla se os caracteres reservados são convertidos em sequências de escape.The dontEscape parameter controls whether reserved characters are translated into escape sequences. Esse parâmetro deve ser definido como true somente se você tiver certeza de que todos os caracteres reservados no URI foram ignorados.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. Definir o valor para true para um URI que não tenha sido completamente escape pode causar um comportamento inesperado.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. É altamente recomendável que você sempre defina esse parâmetro como false.It is strongly recommended that you always set this parameter to false.

Se dontEscape for definido como false, o Construtor escapará todos os caracteres reservados verificando se todas as ocorrências de porcentagem (%) são seguidas por uma sequência de escape válida.If dontEscape is set to false, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. Se a sequência de caracteres após uma porcentagem não for válida, a porcentagem será substituída por% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Este construtor não garante que o Uri faça referência a um recurso acessível.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(String, UriKind) Uri(String, UriKind) Uri(String, UriKind)

Inicializa uma nova instância da classe Uri com URI especificado.Initializes a new instance of the Uri class with the specified URI. Este construtor permite que você especifique se a cadeia de caracteres do URI é um URI relativo, um URI absoluto ou indeterminado.This constructor allows you to specify if the URI string is a relative URI, absolute URI, or is indeterminate.

public:
 Uri(System::String ^ uriString, UriKind uriKind);
public Uri (string uriString, UriKind uriKind);
new Uri : string * UriKind -> Uri

Parâmetros

uriString
String String String String

Uma cadeia de caracteres que identifica o recurso a ser representado pela instância de Uri.A string that identifies the resource to be represented by the Uri instance. Observe que um endereço IPv6 no formato de cadeia de caracteres deve estar entre colchetes.Note that an IPv6 address in string form must be enclosed within brackets. Por exemplo, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

uriKind
UriKind UriKind UriKind UriKind

Especifica se a cadeia de caracteres do URI é um URI relativo, um URI absoluto ou indeterminado.Specifies whether the URI string is a relative URI, absolute URI, or is indeterminate.

Exceções

uriKind é inválido.uriKind is invalid.

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString contém um URI relativo e uriKind é Absolute. uriString contains a relative URI and uriKind is Absolute.

ouor uriString contém um URI absoluto e uriKind é Relative.uriString contains an absolute URI and uriKind is Relative.

ouor uriString está vazio.uriString is empty.

- ou --or- O esquema especificado em uriString não está formado corretamente.The scheme specified in uriString is not correctly formed. Consulte CheckSchemeName(String).See CheckSchemeName(String).

- ou --or- uriString contém muitas barras “/”.uriString contains too many slashes.

- ou --or- A senha especificada em uriString não é válida.The password specified in uriString is not valid.

- ou --or- O nome do host especificado em uriString não é válido.The host name specified in uriString is not valid.

- ou --or- O nome de arquivo especificado em uriString não é válido.The file name specified in uriString is not valid.

- ou --or- O nome de usuário especificado em uriString não é válido.The user name specified in uriString is not valid.

- ou --or- O nome do host ou da autoridade especificado no uriString não pode terminar em barras invertidas.The host or authority name specified in uriString cannot be terminated by backslashes.

- ou --or- O número da porta especificado em uriString não é válido ou não pode ser analisado.The port number specified in uriString is not valid or cannot be parsed.

- ou --or- O comprimento de uriString excede 65.519 caracteres.The length of uriString exceeds 65519 characters.

- ou --or- O comprimento do esquema especificado no uriString excede 1.023 caracteres.The length of the scheme specified in uriString exceeds 1023 characters.

- ou --or- Há uma sequência de caracteres inválida em uriString.There is an invalid character sequence in uriString.

- ou --or- O caminho do MS-DOS especificado em uriString deve começar com c:\\.The MS-DOS path specified in uriString must start with c:\\.

Comentários

URIs relativos e absolutos têm restrições diferentes em seu formato.Relative and absolute URIs have different restrictions on their format. Por exemplo, um URI relativo não requer um esquema ou uma autoridade.For example, a relative URI does not require a scheme or an authority. O valor especificado em uriKind deve corresponder ao tipo de URI uriStringpassado.The value you specify in uriKind must match the type of URI passed in uriString. No entanto RelativeOrAbsolute , se for especificado, a cadeia de caracteres do URI poderá ser relativa ou absoluta.However, if RelativeOrAbsolute is specified, the URI string can be relative or absolute.

Uri(Uri, String) Uri(Uri, String) Uri(Uri, String) Uri(Uri, String)

Inicializa uma nova instância da classe Uri com base no URI base especificado e na cadeia de caracteres do URI relativo.Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

public:
 Uri(Uri ^ baseUri, System::String ^ relativeUri);
public Uri (Uri baseUri, string relativeUri);
new Uri : Uri * string -> Uri
Public Sub New (baseUri As Uri, relativeUri As String)

Parâmetros

baseUri
Uri Uri Uri Uri

O URI de base.The base URI.

relativeUri
String String String String

O URI relativo a ser adicionado ao URI de base.The relative URI to add to the base URI.

Exceções

baseUri não é uma instância de Uri absoluta.baseUri is not an absolute Uri instance.

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

O URI formado pela combinação de baseUri e relativeUri está vazio ou contém apenas espaços.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

- ou --or- O esquema especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O URI formado pela combinação de baseUri e relativeUri contém muitas barras.The URI formed by combining baseUri and relativeUri contains too many slashes.

- ou --or- A senha especificada no URI formado pela combinação de baseUri e relativeUri não é válida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do host especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do arquivo especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome de usuário especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do host ou da autoridade especificado no URI formado pela combinação de baseUri e relativeUri não pode terminar em barras invertidas.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

- ou --or- O número da porta especificado no URI formado pela combinação de baseUri e relativeUri não é válido ou não pode ser analisado.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

- ou --or- O tamanho do URI formado pela combinação de baseUri e relativeUri excede 65.519 caracteres.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

- ou --or- O tamanho do esquema especificado no URI formado pela combinação de baseUri e relativeUri excede 1.023 caracteres.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

- ou --or- Há uma sequência de caracteres inválida no URI formado pela combinação de baseUri e relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

- ou --or- O caminho do MS-DOS especificado em uriString deve começar com c:\\.The MS-DOS path specified in uriString must start with c:\\.

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 para formar o URI http://www.contoso.com/catalog/shownew.htmabsoluto.The following example creates a new instance of the Uri class by combining the relative URIs http://www.contoso.com and catalog/shownew.htm to form the absolute URI http://www.contoso.com/catalog/shownew.htm.

Uri^ baseUri = gcnew Uri(  "http://www.contoso.com" );
Uri^ myUri = gcnew Uri( baseUri, "catalog/shownew.htm" );
Console::WriteLine( myUri->ToString() );
Uri baseUri = new Uri("http://www.contoso.com");
 Uri myUri = new Uri(baseUri, "catalog/shownew.htm");

Console.WriteLine(myUri.ToString());
   
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 baseUri e o relativeUri.This constructor creates a Uri instance by combining the baseUri and the relativeUri. Se relativeUri for um URI absoluto (que contém um esquema, nome de host e, opcionalmente, um número de Uri porta), a instância relativeUriserá criada usando apenas.If relativeUri is an absolute URI (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Se o baseUri tiver partes relativas (como /api), a parte relativa deverá ser terminada com uma barra, (como /api/), se a parte relativa do baseUri for ser preservada no construído Uri.If the baseUri has relative parts (like /api), then the relative part must be terminated with a slash, (like /api/), if the relative part of baseUri is to be preserved in the constructed Uri.

Além disso, se relativeUri o começar com uma barra, ele substituirá qualquer parte relativa dobaseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Este construtor não garante que o Uri faça referência a um recurso acessível.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Inicializa uma nova instância da classe Uri com base na combinação de uma instância base de Uri especificada e uma instância de Uri relativa.Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

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

baseUri
Uri Uri Uri Uri

Um Uri absoluto que é a base da nova instância de Uri.An absolute Uri that is the base for the new Uri instance.

relativeUri
Uri Uri Uri Uri

Uma instância de Uri relativa combinada com baseUri.A relative Uri instance that is combined with baseUri.

Exceções

baseUri não é uma instância de Uri absoluta.baseUri is not an absolute Uri instance.

baseUri não é uma instância de Uri absoluta.baseUri is not an absolute Uri instance.

Em vez disso, no .NET para aplicativos da Windows Store ou na Biblioteca de Classes Portátil, capture a exceção de classe base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

O URI formado pela combinação de baseUri e relativeUri está vazio ou contém apenas espaços.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

- ou --or- O esquema especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O URI formado pela combinação de baseUri e relativeUri contém muitas barras.The URI formed by combining baseUri and relativeUri contains too many slashes.

- ou --or- A senha especificada no URI formado pela combinação de baseUri e relativeUri não é válida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do host especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do arquivo especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome de usuário especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do host ou da autoridade especificado no URI formado pela combinação de baseUri e relativeUri não pode terminar em barras invertidas.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

- ou --or- O número da porta especificado no URI formado pela combinação de baseUri e relativeUri não é válido ou não pode ser analisado.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

- ou --or- O tamanho do URI formado pela combinação de baseUri e relativeUri excede 65.519 caracteres.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

- ou --or- O tamanho do esquema especificado no URI formado pela combinação de baseUri e relativeUri excede 1.023 caracteres.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

- ou --or- Há uma sequência de caracteres inválida no URI formado pela combinação de baseUri e relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

- ou --or- O caminho do MS-DOS especificado em uriString deve começar com c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemplos

Este exemplo cria uma instância Uri absoluta, absoluteUri, e uma instância Uri relativa, relativeUri.This example creates an absolute Uri instance, absoluteUri, and a relative Uri instance, relativeUri. Uma nova Uri instância, combinedUri, é criada A partir dessas duas instâncias.A new Uri instance, combinedUri, is then created from these two instances.

// Create an absolute Uri from a string.
String^ addressString1 = "http://www.contoso.com/";
String^ addressString2 = "catalog/shownew.htm?date=today";
Uri^ absoluteUri = gcnew Uri(addressString1);

// Create a relative Uri from a string.  allowRelative = true to allow for 
// creating a relative Uri.
Uri^ relativeUri = gcnew Uri(addressString2);

// 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 = gcnew Uri( absoluteUri,relativeUri );
Console::WriteLine( combinedUri->AbsoluteUri );
// 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.
    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 'SampleConstructor

Comentários

Esse construtor cria uma nova Uri instância combinando uma instância Uri absoluta, baseUri, com uma instância Uri relativa, relativeUri.This constructor creates a new Uri instance by combining an absolute Uri instance, baseUri, with a relative Uri instance, relativeUri. Se relativeUri é uma instância Uri absoluta (que contém um esquema, um nome de host e, opcionalmente, um número Uri de porta), a relativeUriinstância é criada usando apenas.If relativeUri is an absolute Uri instance (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Se o baseUri tiver partes relativas (como /api), a parte relativa deverá ser terminada com uma barra, (como /api/), se a parte relativa do baseUri for ser preservada no construído Uri.If the baseUri has relative parts (like /api), then the relative part must be terminated with a slash, (like /api/), if the relative part of baseUri is to be preserved in the constructed Uri.

Além disso, se relativeUri o começar com uma barra, ele substituirá qualquer parte relativa dobaseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Este construtor não garante que o Uri faça referência a um recurso acessível.This constructor does not ensure that the Uri refers to an accessible resource.

Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean) Uri(Uri, String, Boolean)

Aviso

Esta API agora é obsoleta.

Inicializa uma nova instância da classe Uri baseada nos URIs de base e relativos especificados, com controle explícito de escape de caracteres.Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

public:
 Uri(Uri ^ baseUri, System::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. http://go.microsoft.com/fwlink/?linkid=14202")]
[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);
new Uri : Uri * string * bool -> Uri
Public Sub New (baseUri As Uri, relativeUri As String, dontEscape As Boolean)

Parâmetros

baseUri
Uri Uri Uri Uri

O URI de base.The base URI.

relativeUri
String String String String

O URI relativo a ser adicionado ao URI de base.The relative URI to add to the base URI.

dontEscape
Boolean Boolean Boolean Boolean

true se uriString tiver escape completo; caso contrário, false.true if uriString is completely escaped; otherwise, false.

Exceções

baseUri não é uma instância de Uri absoluta.baseUri is not an absolute Uri instance.

O URI formado pela combinação de baseUri e relativeUri está vazio ou contém apenas espaços.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

- ou --or- O esquema especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O URI formado pela combinação de baseUri e relativeUri contém muitas barras.The URI formed by combining baseUri and relativeUri contains too many slashes.

- ou --or- A senha especificada no URI formado pela combinação de baseUri e relativeUri não é válida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do host especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do arquivo especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome de usuário especificado no URI formado pela combinação de baseUri e relativeUri não é válido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

- ou --or- O nome do host ou da autoridade especificado no URI formado pela combinação de baseUri e relativeUri não pode terminar em barras invertidas.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

- ou --or- O número da porta especificado no URI formado pela combinação de baseUri e relativeUri não é válido ou não pode ser analisado.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

- ou --or- O tamanho do URI formado pela combinação de baseUri e relativeUri excede 65.519 caracteres.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

- ou --or- O tamanho do esquema especificado no URI formado pela combinação de baseUri e relativeUri excede 1.023 caracteres.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

- ou --or- Há uma sequência de caracteres inválida no URI formado pela combinação de baseUri e relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

- ou --or- O caminho do MS-DOS especificado em uriString deve começar com c:\\.The MS-DOS path specified in uriString must start with c:\\.

Exemplos

O exemplo a seguir cria uma nova instância da Uri classe combinando os URIs http://www.contoso.com relativos e Hello%20World.htm para formar um URI absoluto.The following example creates a new instance of the Uri class by combining the relative URIs http://www.contoso.com and Hello%20World.htm to form an absolute URI.

Uri^ baseUri = gcnew Uri( "http://www.contoso.com/" );
Uri^ myUri = gcnew Uri( baseUri,"Hello%20World.htm",false );
Uri baseUri = new Uri("http://www.contoso.com");
Uri myUri = new Uri(baseUri, "Hello%20World.htm",false);

Dim baseUri As New Uri("http://www.contoso.com")
Dim myUri As New Uri(baseUri, "Hello%20World.htm", False)

Comentários

Esse construtor cria uma Uri instância combinando baseUri e relativeUri.This constructor creates a Uri instance by combining baseUri and relativeUri. Se o URI passado relativeUri for um URI absoluto (que contém um esquema, nome de host e, opcionalmente, um número de porta), a Uri instância será relativeUricriada usando apenas.If the URI passed in relativeUri is an absolute URI (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

O dontEscape parâmetro controla se os caracteres reservados são convertidos em sequências de escape.The dontEscape parameter controls whether reserved characters are translated into escape sequences. Esse parâmetro deve ser definido como true somente se você tiver certeza de que todos os caracteres reservados no URI foram ignorados.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. Definir o valor para true para um URI que não tenha sido completamente escape pode causar um comportamento inesperado.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. É altamente recomendável que você sempre defina esse parâmetro como false.It is strongly recommended that you always set this parameter to false. Se dontEscape for definido como false, o Construtor escapará todos os caracteres reservados verificando se todas as ocorrências de porcentagem (%) são seguidas por uma sequência de escape válida.If dontEscape is set to false, the constructor escapes any reserved characters by checking that all occurrences of percent (%) are followed by a valid escape sequence. Se a sequência de caracteres após uma porcentagem não for válida, a porcentagem será substituída por% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Este construtor não garante que o Uri faça referência a um recurso acessível.This constructor does not ensure that the Uri refers to an accessible resource.

Notas aos Chamadores

Devido a questões de segurança, seu aplicativo não deve chamar esse construtor com cadeias de caracteres de URI de fontes dontEscape não confiáveis truee com definido como.Because of security concerns, your application should not call this constructor with URI strings from untrusted sources and with dontEscape set to true. Como alternativa, você pode verificar uma cadeia de caracteres de URI para fins IsWellFormedOriginalString() de validade chamando o método antes de chamar esse construtor.Alternately, you can check a URI string for validity by calling the IsWellFormedOriginalString() method prior to calling this constructor.

Aplica-se a