Uri Constructeurs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

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

public Uri(string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Paramètres

Exceptions

Exemples

L’exemple suivant crée une Uri instance avec l’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/")

Remarques

Ce constructeur crée une Uri instance à partir d’une chaîne d’URI. Il analyse l’URI, le place au format canonique et effectue tous les encodages d’échappement requis.

Ce constructeur ne garantit pas que les Uri références à une ressource accessible.

Si la uriString valeur représente une adresse IPv6, elle doit être placée entre crochets, par exemple « http://[2607 :f8b0:400d :c06 ::69] ».

Ce constructeur suppose que le string paramètre fait référence à un URI absolu et équivaut à appeler le Uri constructeur avec UriKind la valeur définie Absolutesur . Si le string paramètre passé au constructeur est un URI relatif, ce constructeur lève un UriFormatException.

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

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)

Paramètres

Attributs

ObsoleteAttribute

Exceptions

Remarques

Ce constructeur implémente l’interface ISerializable pour la Uri classe.

Voir aussi

• Sérialisation XML et SOAP

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

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);

[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")]
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

[<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")>]
new Uri : string * bool -> Uri

new Uri : string * bool -> Uri

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

Paramètres

Attributs

ObsoleteAttribute

Exceptions

Remarques

Ce constructeur crée une Uri instance à partir d’une chaîne d’URI. Il analyse l’URI et le place au format canonique.

Le dontEscape paramètre contrôle si les caractères réservés sont traduits en séquences d’échappement. Ce paramètre ne doit être défini true que si vous êtes certain que tous les caractères réservés de l’URI ont été échappés. La définition de la valeur true pour un URI qui n’a pas été complètement échappé peut entraîner un comportement inattendu. Il est fortement recommandé de toujours définir ce paramètre falsesur .

Si dontEscape la valeur est définie false, le constructeur échappe à tous les caractères réservés en vérifiant que toutes les occurrences de pourcentage (%) sont suivies d’une séquence d’échappement valide. Si la séquence de caractères suivant un pourcentage n’est pas valide, le pourcentage est remplacé par %25.

Ce constructeur ne garantit pas que les Uri références à une ressource accessible.

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

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)

Paramètres

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

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)

Paramètres

Exceptions

Remarques

Les URI relatifs et absolus ont des restrictions différentes sur leur format. Par exemple, un URI relatif ne nécessite pas de schéma ou d’autorité. La valeur que vous spécifiez uriKind doit correspondre au type d’URI passé.uriString Toutefois, si RelativeOrAbsolute elle est spécifiée, la chaîne d’URI peut être relative ou absolue.

Pour uriString, une adresse IPv6 sous forme de chaîne doit être placée entre crochets, par exemple « http://[2607 :f8b0:400d :c06 ::69] ».

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

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)

Paramètres

Exceptions

Exemples

L’exemple suivant crée une nouvelle instance de la Uri classe en combinant les URI http://www.contoso.com relatifs et catalog/shownew.htm en formant l’URI http://www.contoso.com/catalog/shownew.htmabsolu.

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())

Remarques

Ce constructeur crée une Uri instance en combinant le baseUri et le relativeUri. S’il relativeUri s’agit d’un URI absolu (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance Uri est créée à l’aide uniquement relativeUri.

Si les baseUri parties relatives (par exemple /api), la partie relative doit être arrêtée avec une barre oblique (par /api/exemple), si la partie relative de celle-ci baseUri doit être conservée dans la construction Uri.

En outre, si la relativeUri barre oblique commence par une barre oblique, elle remplace toute partie relative du baseUri

Ce constructeur ne garantit pas que les Uri références à une ressource accessible.

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

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)

Paramètres

Exceptions

Exemples

Cet exemple crée une instance absolueUri, absoluteUriet une instance relativeUri. relativeUri Une nouvelle Uri instance, combinedUriest ensuite créée à partir de ces deux instances.

// 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

Remarques

Ce constructeur crée une Uri nouvelle instance en combinant une instance absolueUri, baseUriavec une instance relativeUri. relativeUri S’il relativeUri s’agit d’une instance absolue Uri (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance Uri est créée à l’aide uniquement relativeUri.

Si les baseUri parties relatives (par exemple /api), la partie relative doit être arrêtée avec une barre oblique (par /api/exemple), si la partie relative de celle-ci baseUri doit être conservée dans la construction Uri.

En outre, si la relativeUri barre oblique commence par une barre oblique, elle remplace toute partie relative du baseUri.

Ce constructeur ne garantit pas que les Uri références à une ressource accessible.

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

Uri.cs

Source:

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. http://go.microsoft.com/fwlink/?linkid=14202")]
public Uri(Uri baseUri, string relativeUri, bool dontEscape);

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("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

[<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")>]
new Uri : Uri * string * bool -> Uri

new Uri : Uri * string * bool -> Uri

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

Paramètres

Attributs

ObsoleteAttribute

Exceptions

Remarques

Ce constructeur crée une Uri instance en combinant baseUri et relativeUri. Si l’URI passé relativeUri est un URI absolu (contenant un schéma, un nom d’hôte et éventuellement un numéro de port), l’instance Uri est créée à l’aide uniquement relativeUri.

Le dontEscape paramètre contrôle si les caractères réservés sont traduits en séquences d’échappement. Ce paramètre ne doit être défini true que si vous êtes certain que tous les caractères réservés de l’URI ont été échappés. La définition de la valeur true pour un URI qui n’a pas été complètement échappé peut entraîner un comportement inattendu. Il est fortement recommandé de toujours définir ce paramètre falsesur . Si dontEscape la valeur est définie false, le constructeur échappe à tous les caractères réservés en vérifiant que toutes les occurrences de pourcentage (%) sont suivies d’une séquence d’échappement valide. Si la séquence de caractères suivant un pourcentage n’est pas valide, le pourcentage est remplacé par %25.

Ce constructeur ne garantit pas que les Uri références à une ressource accessible.

Notes pour les appelants

En raison de problèmes de sécurité, votre application ne doit pas appeler ce constructeur avec des chaînes d’URI provenant de sources non approuvées et avec dontEscape la valeur définie sur true. Vous pouvez également vérifier la validité d’une chaîne d’URI en appelant la IsWellFormedOriginalString() méthode avant d’appeler ce constructeur.