Uri Costruttori

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

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

public Uri(string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Parametri

Eccezioni

Esempio

Nell'esempio seguente viene creata un'istanza Uri con 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/")

Commenti

Questo costruttore crea un'istanza Uri da una stringa URI. Analizza l'URI, lo inserisce in formato canonico e rende le codifiche di escape necessarie.

Questo costruttore non garantisce che faccia Uri riferimento a una risorsa accessibile.

Se rappresenta uriString un indirizzo IPv6, deve essere racchiuso tra parentesi quadre, ad esempio "http://[2607:f8b0:400d:c06::69]".

Questo costruttore presuppone che il string parametro faccia riferimento a un URI assoluto ed equivale a chiamare il Uri costruttore con UriKind impostato su Absolute. Se il string parametro passato al costruttore è un URI relativo, questo costruttore genera un'eccezione UriFormatException.

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

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)

Parametri

Attributi

ObsoleteAttribute

Eccezioni

Commenti

Questo costruttore implementa l'interfaccia ISerializable per la Uri classe .

Vedi anche

• Serializzazione XML e SOAP

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

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)

Parametri

Attributi

ObsoleteAttribute

Eccezioni

Commenti

Questo costruttore crea un'istanza Uri da una stringa URI. Analizza l'URI e lo inserisce in formato canonico.

Il dontEscape parametro controlla se i caratteri riservati vengono convertiti in sequenze di escape. Questo parametro deve essere impostato su true solo se si è certi che tutti i caratteri riservati nell'URI siano stati preceduti da un carattere di escape. L'impostazione del valore su true per un URI che non è stato completamente preceduto da escape può causare un comportamento imprevisto. È consigliabile impostare sempre questo parametro su false.

Se dontEscape è impostato su false, il costruttore esegue l'escape di tutti i caratteri riservati verificando che tutte le occorrenze di percent (%) siano seguite da una sequenza di escape valida. Se la sequenza di caratteri che segue una percentuale non è valida, la percentuale viene sostituita da %25.

Questo costruttore non garantisce che faccia Uri riferimento a una risorsa accessibile.

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

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)

Parametri

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

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)

Parametri

Eccezioni

Commenti

Gli URI relativi e assoluti hanno restrizioni diverse per il formato. Ad esempio, un URI relativo non richiede uno schema o un'autorità. Il valore specificato in uriKind deve corrispondere al tipo di URI passato in uriString. Tuttavia, se RelativeOrAbsolute viene specificato, la stringa URI può essere relativa o assoluta.

Per uriString, un indirizzo IPv6 in formato stringa deve essere racchiuso tra parentesi quadre, ad esempio "http://[2607:f8b0:400d:c06::69]".

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

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)

Parametri

Eccezioni

Esempio

Nell'esempio seguente viene creata una nuova istanza della Uri classe combinando gli URI http://www.contoso.com relativi e catalog/shownew.htm per formare l'URI http://www.contoso.com/catalog/shownew.htmassoluto.

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

Commenti

Questo costruttore crea un'istanza Uri combinando e baseUrirelativeUri. Se relativeUri è un URI assoluto (contenente uno schema, un nome host e facoltativamente un numero di porta), l'istanza Uri viene creata usando solo relativeUri.

Se ha baseUri parti relative (ad esempio /api), la parte relativa deve essere terminata con una barra, ad esempio /api/, se la parte relativa di baseUri deve essere mantenuta nell'oggetto costruito Uri.

Inoltre, se inizia relativeUri con una barra, sostituirà qualsiasi parte relativa del baseUri

Questo costruttore non garantisce che faccia Uri riferimento a una risorsa accessibile.

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

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)

Parametri

Eccezioni

Esempio

Questo esempio crea un'istanza assoluta Uri , absoluteUrie un'istanza relativa Uri , relativeUri. Una nuova Uri istanza, combinedUri, viene quindi creata da queste due istanze.

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

Commenti

Questo costruttore crea una nuova Uri istanza combinando un'istanza assoluta Uri , baseUri, con un'istanza relativa Uri , relativeUri. Se relativeUri è un'istanza assoluta Uri (contenente uno schema, un nome host e facoltativamente un numero di porta), l'istanza Uri viene creata usando solo relativeUri.

Se ha baseUri parti relative (ad esempio /api), la parte relativa deve essere terminata con una barra, ad esempio /api/, se la parte relativa di baseUri deve essere mantenuta nell'oggetto costruito Uri.

Inoltre, se inizia relativeUri con una barra, sostituirà qualsiasi parte relativa di baseUri.

Questo costruttore non garantisce che faccia Uri riferimento a una risorsa accessibile.

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

Uri.cs

Origine:

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)

Parametri

Attributi

ObsoleteAttribute

Eccezioni

Commenti

Questo costruttore crea un'istanza Uri combinando baseUri e relativeUri. Se l'URI passato relativeUri è un URI assoluto (contenente uno schema, un nome host e facoltativamente un numero di porta), l'istanza Uri viene creata usando solo relativeUri.

Il dontEscape parametro controlla se i caratteri riservati vengono convertiti in sequenze di escape. Questo parametro deve essere impostato su true solo se si è certi che tutti i caratteri riservati nell'URI siano stati preceduti da un carattere di escape. L'impostazione del valore su true per un URI che non è stato completamente preceduto da escape può causare un comportamento imprevisto. È consigliabile impostare sempre questo parametro su false. Se dontEscape è impostato su false, il costruttore esegue l'escape di tutti i caratteri riservati verificando che tutte le occorrenze di percent (%) siano seguite da una sequenza di escape valida. Se la sequenza di caratteri che segue una percentuale non è valida, la percentuale viene sostituita da %25.

Questo costruttore non garantisce che faccia Uri riferimento a una risorsa accessibile.

Note per i chiamanti

A causa di problemi di sicurezza, l'applicazione non deve chiamare questo costruttore con stringhe URI da origini non attendibili e con dontEscape impostato su true. In alternativa, è possibile controllare la validità di una stringa URI chiamando il IsWellFormedOriginalString() metodo prima di chiamare questo costruttore.