Ler em inglês

Compartilhar via


Uri.TryCreate Método

Definição

Cria um novo Uri. Não gera uma exceção se o Uri não pode ser criado.

Sobrecargas

TryCreate(Uri, Uri, Uri)

Cria um novo Uri usando a base especificada e as instâncias de Uri relativas.

TryCreate(Uri, String, Uri)

Cria um novo Uri usando a base especificada e as instâncias de String relativas.

TryCreate(String, UriKind, Uri)

Cria um novo Uri usando a instância String especificada e um UriKind.

TryCreate(String, UriCreationOptions, Uri)

Cria um novo Uri usando a instância especificada String e UriCreationOptions.

TryCreate(Uri, Uri, Uri)

Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs

Cria um novo Uri usando a base especificada e as instâncias de Uri relativas.

C#
public static bool TryCreate(Uri baseUri, Uri relativeUri, out Uri result);
C#
public static bool TryCreate(Uri? baseUri, Uri? relativeUri, out Uri? result);

Parâmetros

baseUri
Uri

O URI de base.

relativeUri
Uri

O URI relativo a ser adicionado ao Uri base.

result
Uri

Quando é retornado, este método contém um Uri construído de baseUri e relativeUri. Este parâmetro é passado não inicializado.

Retornos

true se o Uri foi criado com êxito; caso contrário, false.

Exceções

baseUri é null.

Comentários

Se esse método retornar true, o novo Uri estará em result.

Esse método constrói o URI, coloca-o em forma canônica e o valida. Se ocorrer uma exceção sem tratamento, esse método a capturará. Se você quiser criar um Uri e obter exceções, use um dos Uri construtores.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

TryCreate(Uri, String, Uri)

Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs

Cria um novo Uri usando a base especificada e as instâncias de String relativas.

C#
public static bool TryCreate(Uri baseUri, string relativeUri, out Uri result);
C#
public static bool TryCreate(Uri? baseUri, string? relativeUri, out Uri? result);

Parâmetros

baseUri
Uri

O URI de base.

relativeUri
String

A representação de cadeia de caracteres do URI relativo a ser adicionado ao Uri base.

result
Uri

Quando é retornado, este método contém um Uri construído de baseUri e relativeUri. Este parâmetro é passado não inicializado.

Retornos

true se o Uri foi criado com êxito; caso contrário, false.

Comentários

Se esse método retornar true, o novo Uri estará em result.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

TryCreate(String, UriKind, Uri)

Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs

Cria um novo Uri usando a instância String especificada e um UriKind.

C#
public static bool TryCreate(string uriString, UriKind uriKind, out Uri result);
C#
public static bool TryCreate(string? uriString, UriKind uriKind, out Uri? result);

Parâmetros

uriString
String

A representação de cadeia de caracteres do Uri.

uriKind
UriKind

O tipo do URI.

result
Uri

Quando este método retorna, ele contém o Uri construído.

Retornos

true se o Uri foi criado com êxito; caso contrário, false.

Comentários

Se esse método retornar true, o novo Uri estará em result.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

TryCreate(String, UriCreationOptions, Uri)

Origem:
UriExt.cs
Origem:
UriExt.cs
Origem:
UriExt.cs

Cria um novo Uri usando a instância especificada String e UriCreationOptions.

C#
public static bool TryCreate(string? uriString, in UriCreationOptions creationOptions, out Uri? result);

Parâmetros

uriString
String

A representação de cadeia de caracteres do Uri.

creationOptions
UriCreationOptions

Opções que controlam como o Uri é criado e se comporta.

result
Uri

Quando este método retorna, ele contém o Uri construído.

Retornos

true se o Uri foi criado com êxito; caso contrário, false.

Aplica-se a

.NET 10 e outras versões
Produto Versões
.NET 6, 7, 8, 9, 10