Uri Uri Uri Uri Constructors

Definizione

Overload

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

Inizializza una nuova istanza della classe Uri con l'URI specificato.Initializes a new instance of the Uri class with the specified URI.

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

Inizializza una nuova istanza della classe Uri dalle istanze specificate delle classi 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)

Inizializza una nuova istanza della classe Uri con l'URI specificato e con il controllo esplicito dell'escape dei caratteri.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)

Inizializza una nuova istanza della classe Uri con l'URI specificato.Initializes a new instance of the Uri class with the specified URI. Questo costruttore consente di specificare se la stringa URI è un URI relativo, un URI assoluto o se è indeterminata.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)

Inizializza una nuova istanza della classe Uri basata sull'URI di base specificato e sulla stringa URI relativa.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)

Inizializza una nuova istanza della classe Uri sulla combinazione di un'istanza di Uri di base specificata e un'istanza di 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)

Inizializza una nuova istanza della classe Uri basata sugli URI di base e relativi specificati, con controllo esplicito dell'escape dei caratteri.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)

Inizializza una nuova istanza della classe Uri con l'URI specificato.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)

Parametri

uriString
String String String String

Stringa che identifica la risorsa che deve essere rappresentata dall'istanza di Uri.A string that identifies the resource to be represented by the Uri instance. Si noti che un indirizzo IPv6 in formato di stringa deve essere racchiuso tra parentesi quadre.Note that an IPv6 address in string form must be enclosed within brackets. Ad esempio, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

Eccezioni

In .NET per app di Windows Store o nella libreria di classi portabile rilevare invece l'eccezione della classe di base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString è vuoto. uriString is empty.

In alternativa-or- Lo schema specificato in uriString non ha un formato corretto.The scheme specified in uriString is not correctly formed. Vedere CheckSchemeName(String).See CheckSchemeName(String).

-oppure--or- uriString contiene troppe barre.uriString contains too many slashes.

In alternativa-or- La password specificata in uriString non è valida.The password specified in uriString is not valid.

-oppure--or- Il nome host specificato in uriString non è valido.The host name specified in uriString is not valid.

In alternativa-or- Il nome file specificato in uriString non è valido.The file name specified in uriString is not valid.

-oppure--or- Il nome utente specificato in uriString non è valido.The user name specified in uriString is not valid.

-oppure--or- Il nome host o dell'autorità specificato in uriString non può terminare con barre rovesciate.The host or authority name specified in uriString cannot be terminated by backslashes.

-oppure--or- Il numero di porta specificato in uriString non è valido e non può essere analizzato.The port number specified in uriString is not valid or cannot be parsed.

In alternativa-or- La lunghezza di uriString supera i 65519 caratteri.The length of uriString exceeds 65519 characters.

-oppure--or- La lunghezza dello schema specificato in uriString supera 1023 caratteri.The length of the scheme specified in uriString exceeds 1023 characters.

In alternativa-or- uriString contiene una sequenza di caratteri non valida.There is an invalid character sequence in uriString.

-oppure--or- Il percorso MS-DOS specificato in uriString deve iniziare con c:\\.The MS-DOS path specified in uriString must start with c:\\.

Esempi

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

Commenti

Questo costruttore crea un' Uri istanza da una stringa URI.This constructor creates a Uri instance from a URI string. Analizza l'URI, lo inserisce in formato canonico ed esegue le codifiche di escape obbligatorie.It parses the URI, puts it in canonical format, and makes any required escape encodings.

Questo costruttore non garantisce che Uri faccia riferimento a una risorsa accessibile.This constructor does not ensure that the Uri refers to an accessible resource.

Questo costruttore presuppone che il string parametro faccia riferimento a un URI assoluto ed equivale a chiamare Uri il costruttore UriKind con impostato Absolutesu.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 il string parametro passato al costruttore è un URI relativo, questo costruttore genererà un' UriFormatExceptionoperazione.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)

Inizializza una nuova istanza della classe Uri dalle istanze specificate delle classi 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

Parametri

serializationInfo
SerializationInfo SerializationInfo SerializationInfo SerializationInfo

Istanza della classe SerializationInfo contenente le informazioni necessarie per serializzare la nuova istanza di Uri.An instance of the SerializationInfo class containing the information required to serialize the new Uri instance.

streamingContext
StreamingContext StreamingContext StreamingContext StreamingContext

Istanza della classe StreamingContext contenente l'origine del flusso serializzato associato alla nuova istanza di Uri.An instance of the StreamingContext class containing the source of the serialized stream associated with the new Uri instance.

Eccezioni

Il parametro serializationInfo contiene un URI null.The serializationInfo parameter contains a null URI.

Il parametro serializationInfo contiene un URI vuoto.The serializationInfo parameter contains a URI that is empty.

In alternativa-or- Lo schema specificato non ha un formato corretto.The scheme specified is not correctly formed. Vedere CheckSchemeName(String).See CheckSchemeName(String).

In alternativa-or- L'URI contiene troppe barre.The URI contains too many slashes.

In alternativa-or- La password specificata nell'URI non è valida.The password specified in the URI is not valid.

In alternativa-or- Il nome host specificato nell'URI non è valido.The host name specified in URI is not valid.

-oppure--or- Il nome file specificato nell'URI non è valido.The file name specified in the URI is not valid.

In alternativa-or- Il nome utente specificato nell'URI non è valido.The user name specified in the URI is not valid.

-oppure--or- Il nome host o dell'autorità specificato nell'URI non può terminare con barre rovesciate.The host or authority name specified in the URI cannot be terminated by backslashes.

-oppure--or- Il numero di porta specificato nell'URI non è valido e non può essere analizzato.The port number specified in the URI is not valid or cannot be parsed.

-oppure--or- La lunghezza dell'URI supera i 65519 caratteri.The length of URI exceeds 65519 characters.

-oppure--or- La lunghezza dello schema specificato nell'URI supera i 1023 caratteri.The length of the scheme specified in the URI exceeds 1023 characters.

-oppure--or- L'URI contiene una sequenza di caratteri non valida.There is an invalid character sequence in the URI.

-oppure--or- Il percorso MS-DOS specificato nell'URI deve iniziare con c:\\.The MS-DOS path specified in the URI must start with c:\\.

Commenti

Questo costruttore implementa l' ISerializable interfaccia per la Uri classe.This constructor implements the ISerializable interface for the Uri class.

Vedi anche

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

Avviso

Questa API è ora obsoleta.

Inizializza una nuova istanza della classe Uri con l'URI specificato e con il controllo esplicito dell'escape dei caratteri.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)

Parametri

uriString
String String String String

Stringa che identifica la risorsa che deve essere rappresentata dall'istanza di Uri.A string that identifies the resource to be represented by the Uri instance. Si noti che un indirizzo IPv6 in formato di stringa deve essere racchiuso tra parentesi quadre.Note that an IPv6 address in string form must be enclosed within brackets. Ad esempio, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

dontEscape
Boolean Boolean Boolean Boolean

true se uriString è sottoposto a escape in modo completo. In caso contrario, false.true if uriString is completely escaped; otherwise, false.

Eccezioni

uriString è vuoto o contiene solo spazi.uriString is empty or contains only spaces.

-oppure--or- Lo schema specificato in uriString non è valido.The scheme specified in uriString is not valid.

-oppure--or- uriString contiene troppe barre.uriString contains too many slashes.

In alternativa-or- La password specificata in uriString non è valida.The password specified in uriString is not valid.

-oppure--or- Il nome host specificato in uriString non è valido.The host name specified in uriString is not valid.

In alternativa-or- Il nome file specificato in uriString non è valido.The file name specified in uriString is not valid.

-oppure--or- Il nome utente specificato in uriString non è valido.The user name specified in uriString is not valid.

-oppure--or- Il nome host o dell'autorità specificato in uriString non può terminare con barre rovesciate.The host or authority name specified in uriString cannot be terminated by backslashes.

In alternativa-or- Il numero di porta specificato in uriString non è valido e non può essere analizzato.The port number specified in uriString is not valid or cannot be parsed.

-oppure--or- La lunghezza di uriString supera i 65519 caratteri.The length of uriString exceeds 65519 characters.

-oppure--or- La lunghezza dello schema specificato in uriString supera 1023 caratteri.The length of the scheme specified in uriString exceeds 1023 characters.

-oppure--or- uriString contiene una sequenza di caratteri non valida.There is an invalid character sequence in uriString.

In alternativa-or- Il percorso MS-DOS specificato in uriString deve iniziare con c:\\.The MS-DOS path specified in uriString must start with c:\\.

Esempi

Nell'esempio seguente viene creata Uri un'istanza per l' http://www.contoso.com/Hello%20World.htmURI.The following example creates a Uri instance for the URI http://www.contoso.com/Hello%20World.htm. Poiché l'URI contenuto è completamente preceduto da un carattere di escape e è dontEscape in forma canonica, trueil parametro può essere impostato su.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)

Commenti

Questo costruttore crea un' Uri istanza da una stringa URI.This constructor creates a Uri instance from a URI string. Analizza l'URI e lo inserisce nel formato canonico.It parses the URI and puts it in canonical format.

Il dontEscape parametro controlla se i caratteri riservati vengono convertiti in sequenze di escape.The dontEscape parameter controls whether reserved characters are translated into escape sequences. 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.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. L'impostazione del valore true su per un URI che non è stato completamente sottoposto a escape può causare un comportamento imprevisto.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. È consigliabile impostare sempre questo parametro su false.It is strongly recommended that you always set this parameter to false.

Se dontEscape è impostato su false, il costruttore deve eseguire l'escape di tutti i caratteri riservati verificando che tutte le occorrenze della percentuale (%) sono seguite da una sequenza di escape valida.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 la sequenza di caratteri che segue una percentuale non è valida, la percentuale viene sostituita da% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Questo costruttore non garantisce che Uri faccia riferimento a una risorsa accessibile.This constructor does not ensure that the Uri refers to an accessible resource.

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

Inizializza una nuova istanza della classe Uri con l'URI specificato.Initializes a new instance of the Uri class with the specified URI. Questo costruttore consente di specificare se la stringa URI è un URI relativo, un URI assoluto o se è indeterminata.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

Parametri

uriString
String String String String

Stringa che identifica la risorsa che deve essere rappresentata dall'istanza di Uri.A string that identifies the resource to be represented by the Uri instance. Si noti che un indirizzo IPv6 in formato di stringa deve essere racchiuso tra parentesi quadre.Note that an IPv6 address in string form must be enclosed within brackets. Ad esempio, "http://[2607:f8b0:400d:c06::69]".For example, "http://[2607:f8b0:400d:c06::69]".

uriKind
UriKind UriKind UriKind UriKind

Specifica se la stringa URI è un URI relativo, un URI assoluto o se è indeterminata.Specifies whether the URI string is a relative URI, absolute URI, or is indeterminate.

Eccezioni

uriKind non è valido.uriKind is invalid.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare invece l'eccezione della classe di base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

uriString contiene un URI relativo e uriKind è Absolute. uriString contains a relative URI and uriKind is Absolute.

oppureor uriString contiene un URI assoluto e uriKind è Relative.uriString contains an absolute URI and uriKind is Relative.

oppureor uriString è vuoto.uriString is empty.

In alternativa-or- Lo schema specificato in uriString non ha un formato corretto.The scheme specified in uriString is not correctly formed. Vedere CheckSchemeName(String).See CheckSchemeName(String).

-oppure--or- uriString contiene troppe barre.uriString contains too many slashes.

-oppure--or- La password specificata in uriString non è valida.The password specified in uriString is not valid.

In alternativa-or- Il nome host specificato in uriString non è valido.The host name specified in uriString is not valid.

In alternativa-or- Il nome file specificato in uriString non è valido.The file name specified in uriString is not valid.

-oppure--or- Il nome utente specificato in uriString non è valido.The user name specified in uriString is not valid.

-oppure--or- Il nome host o dell'autorità specificato in uriString non può terminare con barre rovesciate.The host or authority name specified in uriString cannot be terminated by backslashes.

-oppure--or- Il numero di porta specificato in uriString non è valido e non può essere analizzato.The port number specified in uriString is not valid or cannot be parsed.

-oppure--or- La lunghezza di uriString supera i 65519 caratteri.The length of uriString exceeds 65519 characters.

In alternativa-or- La lunghezza dello schema specificato in uriString supera 1023 caratteri.The length of the scheme specified in uriString exceeds 1023 characters.

-oppure--or- uriString contiene una sequenza di caratteri non valida.There is an invalid character sequence in uriString.

-oppure--or- Il percorso MS-DOS specificato in uriString deve iniziare con c:\\.The MS-DOS path specified in uriString must start with c:\\.

Commenti

Gli URI relativi e assoluti hanno limitazioni diverse rispetto al relativo formato.Relative and absolute URIs have different restrictions on their format. Un URI relativo, ad esempio, non richiede uno schema o un'autorità.For example, a relative URI does not require a scheme or an authority. Il valore specificato in uriKind deve corrispondere al tipo di URI uriStringpassato.The value you specify in uriKind must match the type of URI passed in uriString. Tuttavia, se RelativeOrAbsolute si specifica, la stringa URI può essere relativa o assoluta.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)

Inizializza una nuova istanza della classe Uri basata sull'URI di base specificato e sulla stringa URI relativa.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)

Parametri

baseUri
Uri Uri Uri Uri

URI di base.The base URI.

relativeUri
String String String String

URI relativo da aggiungere all'URI di base.The relative URI to add to the base URI.

Eccezioni

baseUri non è un'istanza di Uri assoluta.baseUri is not an absolute Uri instance.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare invece l'eccezione della classe di base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

L'URI formato dalla combinazione di baseUri e relativeUri è vuoto o contiene solo spazi.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

-oppure--or- Lo schema specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

In alternativa-or- L'URI formato dalla combinazione di baseUri e relativeUri contiene troppe barre.The URI formed by combining baseUri and relativeUri contains too many slashes.

-oppure--or- La password specificata nell'URI formato dalla combinazione di baseUri e relativeUri non è valida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

In alternativa-or- Il nome host specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome file specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome utente specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome host o dell'autorità specificato nell'URI formato dalla combinazione di baseUri e relativeUri non può terminare con barre rovesciate.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

-oppure--or- Il numero di porta specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido o non può essere analizzato.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

In alternativa-or- La lunghezza dell'URI formato dalla combinazione di baseUri e relativeUri supera i 65519 caratteri.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

In alternativa-or- La lunghezza dello schema specificato nell'URI formato dalla combinazione di baseUri e relativeUri supera i 1023 caratteri.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

-oppure--or- È presente una sequenza di caratteri non valida nell'URI formato dalla combinazione di baseUri e relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

-oppure--or- Il percorso MS-DOS specificato in uriString deve iniziare con c:\\.The MS-DOS path specified in uriString must start with c:\\.

Esempi

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

Commenti

Questo costruttore crea un' Uri istanza di baseUri combinando e relativeUri.This constructor creates a Uri instance by combining the baseUri and the relativeUri. Se relativeUri è un URI assoluto (contenente uno schema, un nome host e facoltativamente un numero di porta), Uri l'istanza viene creata solo relativeUriutilizzando.If relativeUri is an absolute URI (containing a scheme, host name, and optionally a port number), the Uri instance is created using only relativeUri.

Uri baseUri /api/ /apiSe dispone di parti relative (ad esempio), la parte relativa deve terminare con una barra, ad esempio, se la parte relativa di deve essere mantenuta nell'oggetto costruito. baseUriIf 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.

Inoltre, se relativeUri inizia con una barra, sostituirà qualsiasi parte relativa delbaseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Questo costruttore non garantisce che Uri faccia riferimento a una risorsa accessibile.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)

Inizializza una nuova istanza della classe Uri sulla combinazione di un'istanza di Uri di base specificata e un'istanza di 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)

Parametri

baseUri
Uri Uri Uri Uri

Oggetto Uri assoluto che costituisce la base per la nuova istanza di Uri.An absolute Uri that is the base for the new Uri instance.

relativeUri
Uri Uri Uri Uri

Istanza di Uri relativa combinata con baseUri.A relative Uri instance that is combined with baseUri.

Eccezioni

baseUri non è un'istanza di Uri assoluta.baseUri is not an absolute Uri instance.

baseUri non è un'istanza di Uri assoluta.baseUri is not an absolute Uri instance.

In .NET per app di Windows Store o nella libreria di classi portabile rilevare invece l'eccezione della classe di base, FormatException.In the .NET for Windows Store apps or the Portable Class Library, catch the base class exception, FormatException, instead.

L'URI formato dalla combinazione di baseUri e relativeUri è vuoto o contiene solo spazi.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

In alternativa-or- Lo schema specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- L'URI formato dalla combinazione di baseUri e relativeUri contiene troppe barre.The URI formed by combining baseUri and relativeUri contains too many slashes.

In alternativa-or- La password specificata nell'URI formato dalla combinazione di baseUri e relativeUri non è valida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome host specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome file specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome utente specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome host o dell'autorità specificato nell'URI formato dalla combinazione di baseUri e relativeUri non può terminare con barre rovesciate.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

-oppure--or- Il numero di porta specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido o non può essere analizzato.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

-oppure--or- La lunghezza dell'URI formato dalla combinazione di baseUri e relativeUri supera i 65519 caratteri.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

-oppure--or- La lunghezza dello schema specificato nell'URI formato dalla combinazione di baseUri e relativeUri supera i 1023 caratteri.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

-oppure--or- È presente una sequenza di caratteri non valida nell'URI formato dalla combinazione di baseUri e relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

In alternativa-or- Il percorso MS-DOS specificato in uriString deve iniziare con c:\\.The MS-DOS path specified in uriString must start with c:\\.

Esempi

Questo esempio crea un'istanza Uri assoluta, absoluteUri, e un'istanza Uri relativa, relativeUri.This example creates an absolute Uri instance, absoluteUri, and a relative Uri instance, relativeUri. Viene quindi Uri creata una combinedUrinuova istanza di da queste due istanze.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

Commenti

Questo costruttore crea una nuova Uri istanza di combinando un' Uri istanza assoluta baseUri,, con un' Uri istanza relativeUrirelativa.This constructor creates a new Uri instance by combining an absolute Uri instance, baseUri, with a relative Uri instance, relativeUri. Se relativeUri è un'istanza Uri assoluta (contenente uno schema, un nome host e facoltativamente un numero di porta), Uri l'istanza viene creata solo relativeUriutilizzando.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.

Uri baseUri /api/ /apiSe dispone di parti relative (ad esempio), la parte relativa deve terminare con una barra, ad esempio, se la parte relativa di deve essere mantenuta nell'oggetto costruito. baseUriIf 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.

Inoltre, se relativeUri inizia con una barra, sostituirà qualsiasi parte relativa delbaseUriAdditionally, if the relativeUri begins with a slash, then it will replace any relative part of the baseUri

Questo costruttore non garantisce che Uri faccia riferimento a una risorsa accessibile.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)

Avviso

Questa API è ora obsoleta.

Inizializza una nuova istanza della classe Uri basata sugli URI di base e relativi specificati, con controllo esplicito dell'escape dei caratteri.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)

Parametri

baseUri
Uri Uri Uri Uri

URI di base.The base URI.

relativeUri
String String String String

URI relativo da aggiungere all'URI di base.The relative URI to add to the base URI.

dontEscape
Boolean Boolean Boolean Boolean

true se uriString è sottoposto a escape in modo completo. In caso contrario, false.true if uriString is completely escaped; otherwise, false.

Eccezioni

baseUri non è un'istanza di Uri assoluta.baseUri is not an absolute Uri instance.

L'URI formato dalla combinazione di baseUri e relativeUri è vuoto o contiene solo spazi.The URI formed by combining baseUri and relativeUri is empty or contains only spaces.

In alternativa-or- Lo schema specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The scheme specified in the URI formed by combining baseUri and relativeUri is not valid.

In alternativa-or- L'URI formato dalla combinazione di baseUri e relativeUri contiene troppe barre.The URI formed by combining baseUri and relativeUri contains too many slashes.

In alternativa-or- La password specificata nell'URI formato dalla combinazione di baseUri e relativeUri non è valida.The password specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome host specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The host name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome file specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The file name specified in the URI formed by combining baseUri and relativeUri is not valid.

-oppure--or- Il nome utente specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido.The user name specified in the URI formed by combining baseUri and relativeUri is not valid.

In alternativa-or- Il nome host o dell'autorità specificato nell'URI formato dalla combinazione di baseUri e relativeUri non può terminare con barre rovesciate.The host or authority name specified in the URI formed by combining baseUri and relativeUri cannot be terminated by backslashes.

-oppure--or- Il numero di porta specificato nell'URI formato dalla combinazione di baseUri e relativeUri non è valido o non può essere analizzato.The port number specified in the URI formed by combining baseUri and relativeUri is not valid or cannot be parsed.

-oppure--or- La lunghezza dell'URI formato dalla combinazione di baseUri e relativeUri supera i 65519 caratteri.The length of the URI formed by combining baseUri and relativeUri exceeds 65519 characters.

-oppure--or- La lunghezza dello schema specificato nell'URI formato dalla combinazione di baseUri e relativeUri supera i 1023 caratteri.The length of the scheme specified in the URI formed by combining baseUri and relativeUri exceeds 1023 characters.

-oppure--or- È presente una sequenza di caratteri non valida nell'URI formato dalla combinazione di baseUri e relativeUri.There is an invalid character sequence in the URI formed by combining baseUri and relativeUri.

-oppure--or- Il percorso MS-DOS specificato in uriString deve iniziare con c:\\.The MS-DOS path specified in uriString must start with c:\\.

Esempi

Nell'esempio seguente viene creata una nuova istanza della Uri classe combinando gli URI http://www.contoso.com relativi e Hello%20World.htm per formare un URI assoluto.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)

Commenti

Questo costruttore crea un' Uri istanza di combinando relativeUri baseUri e.This constructor creates a Uri instance by combining baseUri and relativeUri. Se l'URI passato relativeUri è un URI assoluto (contenente uno schema, un nome host e facoltativamente un numero di porta), l' Uri istanza viene creata solo relativeUriutilizzando.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.

Il dontEscape parametro controlla se i caratteri riservati vengono convertiti in sequenze di escape.The dontEscape parameter controls whether reserved characters are translated into escape sequences. 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.This parameter should be set to true only if you are certain that all reserved characters in the URI have been escaped. L'impostazione del valore true su per un URI che non è stato completamente sottoposto a escape può causare un comportamento imprevisto.Setting the value to true for a URI that has not been completely escaped can cause unexpected behavior. È consigliabile impostare sempre questo parametro su false.It is strongly recommended that you always set this parameter to false. Se dontEscape è impostato su false, il costruttore deve eseguire l'escape di tutti i caratteri riservati verificando che tutte le occorrenze della percentuale (%) sono seguite da una sequenza di escape valida.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 la sequenza di caratteri che segue una percentuale non è valida, la percentuale viene sostituita da% 25.If the character sequence following a percent is not valid, the percent is replaced by %25.

Questo costruttore non garantisce che Uri faccia riferimento a una risorsa accessibile.This constructor does not ensure that the Uri refers to an accessible resource.

Note per i chiamanti

Per motivi di sicurezza, l'applicazione non deve chiamare questo costruttore con stringhe URI provenienti da origini non attendibili dontEscape e con trueimpostato su.Because of security concerns, your application should not call this constructor with URI strings from untrusted sources and with dontEscape set to true. In alternativa, è possibile controllare la validità di una stringa URI chiamando il IsWellFormedOriginalString() metodo prima di chiamare questo costruttore.Alternately, you can check a URI string for validity by calling the IsWellFormedOriginalString() method prior to calling this constructor.

Si applica a