Uri Konstruktorer
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Initierar en ny instans av Uri klassen.
Överlagringar
| Name | Description |
|---|---|
| Uri(String) |
Initierar en ny instans av Uri klassen med angiven URI. |
| Uri(SerializationInfo, StreamingContext) |
Föråldrad.
Initierar en ny instans av Uri klassen från de angivna instanserna av SerializationInfo klasserna och StreamingContext . |
| Uri(String, Boolean) |
Föråldrad.
Föråldrad.
Föråldrad.
Föråldrad.
Initierar en ny instans av Uri klassen med den angivna URI:n, med explicit kontroll över tecken som flyr. |
| Uri(String, UriCreationOptions) |
Initierar en ny instans av Uri klassen med angiven URI och ytterligare UriCreationOptions. |
| Uri(String, UriKind) |
Initierar en ny instans av Uri klassen med angiven URI. Med den här konstruktorn kan du ange om URI-strängen är en relativ URI, absolut URI eller är obestämd. |
| Uri(Uri, String) |
Initierar en ny instans av Uri klassen baserat på den angivna bas-URI:n och den relativa URI-strängen. |
| Uri(Uri, Uri) |
Initierar en ny instans av Uri klassen baserat på kombinationen av en angiven basinstans Uri och en relativ Uri instans. |
| Uri(Uri, String, Boolean) |
Föråldrad.
Föråldrad.
Föråldrad.
Föråldrad.
Initierar en ny instans av Uri klassen baserat på angivna bas- och relativa URI:er, med explicit kontroll över tecken som flyr. |
Uri(String)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
Initierar en ny instans av Uri klassen med angiven URI.
public:
Uri(System::String ^ uriString);
public Uri(string uriString);
new Uri : string -> Uri
Public Sub New (uriString As String)
Parametrar
Undantag
uriString är null.
Obs! I .NET för Windows Store-appar eller Portable Class Library fångar du basklassfelet FormatException i stället.
uriString är tom.
-eller-
Schemat som anges i uriString är inte korrekt format. Se även CheckSchemeName(String).
-eller-
uriString innehåller för många snedstreck.
-eller-
Lösenordet, värdnamnet, filnamnet eller användarnamnet som anges i uriString är inte giltigt.
-eller-
Värd- eller utfärdarnamnet som anges i uriString avslutas av omvänt snedstreck.
-eller-
Portnumret som anges i uriString är ogiltigt eller kan inte parsas.
-eller-
Längden på uriString överskrider 65519 tecken (endast .NET 9 och tidigare versioner).
-eller-
Längden på schemat som anges i uriString överskrider 1 023 tecken.
-eller-
Det finns en ogiltig teckensekvens i uriString.
-eller-
Den MS-DOS sökväg som anges i uriString börjar inte med c:\\.
Exempel
I följande exempel skapas en Uri instans med URI http://www.contoso.com/:n .
Uri myUri = new Uri("http://www.contoso.com/");
let myUri = Uri "http://www.contoso.com/"
Dim myUri As New Uri("http://www.contoso.com/")
Kommentarer
Den här konstruktorn skapar en Uri instans från en URI-sträng. Den parsar URI:n, placerar den i kanoniskt format och gör alla nödvändiga escape-kodningar.
Den här konstruktorn ser inte till att Uri refererar till en tillgänglig resurs.
uriString Om representerar en IPv6-adress måste den omges av hakparenteser, till exempel "http://[2607:f8b0:400d:c06::69]".
Den här konstruktorn förutsätter att parametern string refererar till en absolut URI och motsvarar att anropa Uri konstruktorn med UriKind inställt på Absolute. Om parametern string som skickas till konstruktorn är en relativ URI genererar konstruktorn en UriFormatException.
Gäller för
Uri(SerializationInfo, StreamingContext)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
Varning
This API supports obsolete formatter-based serialization. It should not be called or extended by application code.
Initierar en ny instans av Uri klassen från de angivna instanserna av SerializationInfo klasserna och 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}")]
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)
Parametrar
- serializationInfo
- SerializationInfo
Den information som krävs för att serialisera den nya Uri instansen.
- streamingContext
- StreamingContext
Källan till den serialiserade dataström som är associerad med den nya Uri instansen.
- Attribut
Undantag
Parametern serializationInfo innehåller en null URI.
Parametern serializationInfo innehåller en URI som är tom.
-eller-
Det angivna schemat är inte korrekt format. Se även CheckSchemeName(String).
-eller-
URI:n innehåller för många snedstreck.
-eller-
Lösenordet, värdnamnet, filnamnet eller användarnamnet som anges i URI:n är inte giltigt.
-eller-
Värd- eller utfärdarnamnet som anges i URI:n avslutas av omvänt snedstreck.
-eller-
Portnumret som anges i URI:n är ogiltigt eller kan inte parsas.
-eller-
Längden på URI:n överskrider 65519 tecken (endast .NET 9 och tidigare versioner).
-eller-
Längden på schemat som anges i URI:n överskrider 1 023 tecken.
-eller-
Det finns en ogiltig teckensekvens i URI:n.
-eller-
Den MS-DOS sökväg som anges i URI:n börjar inte med c:\\.
Kommentarer
Den här konstruktorn implementerar ISerializable gränssnittet för Uri klassen.
Se även
Gäller för
Uri(String, Boolean)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
Varning
This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(string) instead.
Varning
This constructor has been deprecated. Use Uri(string) instead.
Varning
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
Varning
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
Initierar en ny instans av Uri klassen med den angivna URI:n, med explicit kontroll över tecken som flyr.
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)
Parametrar
- uriString
- String
En sträng som identifierar resursen som ska representeras av instansen Uri . Observera att en IPv6-adress i strängform måste omges av hakparenteser. Till exempel "http://[2607:f8b0:400d:c06::69]".
- dontEscape
- Boolean
true if uriString is completely escape; otherwise, false.
- Attribut
Undantag
uriString är null.
uriString är tom eller innehåller endast blanksteg.
-eller-
Schemat som anges i uriString är ogiltigt.
-eller-
uriString innehåller för många snedstreck.
-eller-
Lösenordet, värdnamnet, filnamnet eller användarnamnet som anges i uriString är inte giltigt.
-eller-
Värd- eller utfärdarnamnet som anges i uriString avslutas av omvänt snedstreck.
-eller-
Portnumret som anges i uriString är ogiltigt eller kan inte parsas.
-eller-
Längden på uriString överskrider 65519 tecken (endast .NET 9 och tidigare versioner).
-eller-
Längden på schemat som anges i uriString överskrider 1 023 tecken.
-eller-
Det finns en ogiltig teckensekvens i uriString.
-eller-
Den MS-DOS sökväg som anges i uriString börjar inte med c:\\.
Kommentarer
Den här konstruktorn skapar en Uri instans från en URI-sträng. Den parsar URI:n och placerar den i kanoniskt format.
Parametern dontEscape styr om reserverade tecken översätts till escape-sekvenser. Den här parametern ska endast anges till true om du är säker på att alla reserverade tecken i URI:n har undantagits. Om du anger värdet till true för en URI som inte helt har undantagits kan det orsaka oväntat beteende. Vi rekommenderar starkt att du alltid anger den här parametern till false.
Om dontEscape är inställt på falseundflyr konstruktorn alla reserverade tecken genom att kontrollera att alla förekomster av procent (%) följs av en giltig escape-sekvens. Om teckensekvensen efter en procent inte är giltig ersätts procenten av %25.
Den här konstruktorn ser inte till att Uri refererar till en tillgänglig resurs.
Gäller för
Uri(String, UriCreationOptions)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
Initierar en ny instans av Uri klassen med angiven URI och ytterligare UriCreationOptions.
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)
Parametrar
- creationOptions
- UriCreationOptions
Alternativ som styr hur Uri skapas och fungerar.
Gäller för
Uri(String, UriKind)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
Initierar en ny instans av Uri klassen med angiven URI. Med den här konstruktorn kan du ange om URI-strängen är en relativ URI, absolut URI eller är obestämd.
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)
Parametrar
- uriKind
- UriKind
Anger om URI-strängen är en relativ URI, absolut URI eller är obestämd.
Undantag
uriKind är ogiltigt.
uriString är null.
Obs! I .NET för Windows Store-appar eller Portable Class Library fångar du basklassfelet FormatException i stället.
uriString innehåller en relativ URI och uriKind är Absolute.
eller
uriString innehåller en absolut URI och uriKind är Relative.
eller
uriString är tom.
-eller-
Schemat som anges i uriString är inte korrekt format. Se även CheckSchemeName(String).
-eller-
uriString innehåller för många snedstreck.
-eller-
Lösenordet, värdnamnet, filnamnet eller användarnamnet som anges i uriString är inte giltigt.
-eller-
Värd- eller utfärdarnamnet som anges i uriString avslutas av omvänt snedstreck.
-eller-
Portnumret som anges i uriString är ogiltigt eller kan inte parsas.
-eller-
Längden på uriString överskrider 65519 tecken (endast .NET 9 och tidigare versioner).
-eller-
Längden på schemat som anges i uriString överskrider 1 023 tecken.
-eller-
Det finns en ogiltig teckensekvens i uriString.
-eller-
Den MS-DOS sökväg som anges i uriString börjar inte med c:\\.
Kommentarer
Relativa och absoluta URI:er har olika begränsningar för deras format. En relativ URI kräver till exempel inte något schema eller en utfärdare. Värdet du anger i uriKind måste matcha typen av URI som skickas i uriString. Men om RelativeOrAbsolute anges kan URI-strängen vara relativ eller absolut.
För uriStringmåste en IPv6-adress i strängform omges inom hakparenteser, till exempel "http://[2607:f8b0:400d:c06::69]".
Gäller för
Uri(Uri, String)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
Initierar en ny instans av Uri klassen baserat på den angivna bas-URI:n och den relativa URI-strängen.
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)
Parametrar
- baseUri
- Uri
Bas-URI:n.
- relativeUri
- String
Den relativa URI som ska läggas till i bas-URI:n.
Undantag
baseUri är null.
baseUri är inte en absolut Uri instans.
Den URI som skapas genom att kombinera baseUri och relativeUri är tom eller innehåller endast blanksteg.
-eller-
Schemat som anges i URI:n som bildas genom att kombinera baseUri och relativeUri är inte giltigt.
-eller-
Den URI som skapas genom att kombinera baseUri och relativeUri innehåller för många snedstreck.
-eller-
Lösenordet, värdnamnet, filnamnet eller användarnamnet som anges i URI:n som skapas genom att kombinera baseUri och relativeUri är ogiltigt.
-eller-
Värd- eller utfärdarnamnet som anges i den URI som bildas genom att kombinera baseUri och relativeUri avslutas av omvänt snedstreck.
-eller-
Det portnummer som anges i URI:n som bildas genom att kombinera baseUri och relativeUri är ogiltigt eller kan inte parsas.
-eller-
Längden på den URI som bildas genom att kombinera baseUri och relativeUri överskrider 65519 tecken (endast .NET 9 och tidigare versioner).
-eller-
Längden på schemat som anges i den URI som bildas genom att kombinera baseUri och relativeUri överskrider 1 023 tecken.
-eller-
Det finns en ogiltig teckensekvens i URI:n som bildas genom att kombinera baseUri och relativeUri.
-eller-
Den MS-DOS sökväg som anges i baseUri börjar inte med c:\\.
Exempel
I följande exempel skapas en ny instans av Uri klassen genom att de relativa URI:erna http://www.contoso.com kombineras och catalog/shownew.htm den absoluta URI: http://www.contoso.com/catalog/shownew.htmn skapas.
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())
Kommentarer
Den här konstruktorn skapar en Uri instans genom att baseUri kombinera och relativeUri. Om relativeUri är en absolut URI (som innehåller ett schema, värdnamn och eventuellt ett portnummer) skapas instansen Uri endast relativeUrimed .
Om har baseUri relativa delar (som /api), måste den relativa delen avslutas med ett snedstreck, (t.ex /api/. ), om den relativa delen av baseUri ska bevaras Urii den konstruerade .
Om det relativeUri börjar med ett snedstreck ersätter det dessutom en relativ del av baseUri
Den här konstruktorn ser inte till att Uri refererar till en tillgänglig resurs.
Gäller för
Uri(Uri, Uri)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- 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)
Parametrar
Undantag
baseUri är inte en absolut Uri instans.
baseUri är null.
baseUri är inte en absolut Uri instans.
Obs! I .NET för Windows Store-appar eller Portable Class Library fångar du basklassfelet FormatException i stället.
Den URI som skapas genom att kombinera baseUri och relativeUri är tom eller innehåller endast blanksteg.
-eller-
Schemat som anges i URI:n som bildas genom att kombinera baseUri och relativeUri är inte giltigt.
-eller-
Den URI som skapas genom att kombinera baseUri och relativeUri innehåller för många snedstreck.
-eller-
Lösenordet, värdnamnet, filnamnet eller användarnamnet som anges i URI:n som skapas genom att kombinera baseUri och relativeUri är ogiltigt.
-eller-
Värd- eller utfärdarnamnet som anges i den URI som bildas genom att kombinera baseUri och relativeUri avslutas av omvänt snedstreck.
-eller-
Det portnummer som anges i URI:n som bildas genom att kombinera baseUri och relativeUri är ogiltigt eller kan inte parsas.
-eller-
Längden på den URI som bildas genom att kombinera baseUri och relativeUri överskrider 65519 tecken (endast .NET 9 och tidigare versioner).
-eller-
Längden på schemat som anges i den URI som bildas genom att kombinera baseUri och relativeUri överskrider 1 023 tecken.
-eller-
Det finns en ogiltig teckensekvens i URI:n som bildas genom att kombinera baseUri och relativeUri.
-eller-
Den MS-DOS sökväg som anges i baseUri börjar inte med c:\\.
Exempel
Det här exemplet skapar en absolut Uri instans, absoluteUri, och en relativ Uri instans, relativeUri. En ny Uri instans, combinedUri, skapas sedan från dessa två instanser.
// 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
Kommentarer
Den här konstruktorn skapar en ny Uri instans genom att kombinera en absolut Uri instans, , baseUrimed en relativ Uri instans, relativeUri. Om relativeUri är en absolut Uri instans (som innehåller ett schema, värdnamn och eventuellt ett portnummer) skapas instansen Uri endast relativeUrimed .
Om har baseUri relativa delar (som /api), måste den relativa delen avslutas med ett snedstreck, (t.ex /api/. ), om den relativa delen av baseUri ska bevaras Urii den konstruerade .
Om det relativeUri börjar med ett snedstreck ersätter det dessutom en relativ del av baseUri.
Den här konstruktorn ser inte till att Uri refererar till en tillgänglig resurs.
Gäller för
Uri(Uri, String, Boolean)
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
- Källa:
- Uri.cs
Varning
This constructor has been deprecated; the dontEscape parameter is always false. Use Uri(Uri, string) instead.
Varning
This constructor has been deprecated. Use Uri(Uri, string) instead.
Varning
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
Varning
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
Initierar en ny instans av Uri klassen baserat på angivna bas- och relativa URI:er, med explicit kontroll över tecken som flyr.
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)
Parametrar
- baseUri
- Uri
Bas-URI:n.
- relativeUri
- String
Den relativa URI som ska läggas till i bas-URI:n.
- dontEscape
- Boolean
true if baseUri och relativeUri are completely escape;wise, false.
- Attribut
Undantag
baseUri är null.
baseUri är inte en absolut Uri instans.
Den URI som skapas genom att kombinera baseUri och relativeUri är tom eller innehåller endast blanksteg.
-eller-
Schemat som anges i URI:n som bildas genom att kombinera baseUri och relativeUri är inte giltigt.
-eller-
Den URI som skapas genom att kombinera baseUri och relativeUri innehåller för många snedstreck.
-eller-
Lösenordet, värdnamnet, filnamnet eller användarnamnet som anges i URI:n som skapas genom att kombinera baseUri och relativeUri är ogiltigt.
-eller-
Värd- eller utfärdarnamnet som anges i den URI som bildas genom att kombinera baseUri och relativeUri avslutas av omvänt snedstreck.
-eller-
Det portnummer som anges i URI:n som bildas genom att kombinera baseUri och relativeUri är ogiltigt eller kan inte parsas.
-eller-
Längden på den URI som bildas genom att kombinera baseUri och relativeUri överskrider 65519 tecken (endast .NET 9 och tidigare versioner).
-eller-
Längden på schemat som anges i den URI som bildas genom att kombinera baseUri och relativeUri överskrider 1 023 tecken.
-eller-
Det finns en ogiltig teckensekvens i URI:n som bildas genom att kombinera baseUri och relativeUri.
-eller-
Den MS-DOS sökväg som anges i baseUri börjar inte med c:\\.
Kommentarer
Den här konstruktorn skapar en Uri instans genom att kombinera baseUri och relativeUri. Om den URI som skickas in relativeUri är en absolut URI (som innehåller ett schema, värdnamn och eventuellt ett portnummer) skapas instansen Uri endast relativeUrimed .
Parametern dontEscape styr om reserverade tecken översätts till escape-sekvenser. Den här parametern ska endast anges till true om du är säker på att alla reserverade tecken i URI:n har undantagits. Om du anger värdet till true för en URI som inte helt har undantagits kan det orsaka oväntat beteende. Vi rekommenderar starkt att du alltid anger den här parametern till false. Om dontEscape är inställt på falseundflyr konstruktorn alla reserverade tecken genom att kontrollera att alla förekomster av procent (%) följs av en giltig escape-sekvens. Om teckensekvensen efter en procent inte är giltig ersätts procenten av %25.
Den här konstruktorn ser inte till att Uri refererar till en tillgänglig resurs.
Anteckningar till anropare
På grund av säkerhetsproblem bör programmet inte anropa den här konstruktorn med URI-strängar från ej betrodda källor och med dontEscape inställt på true. Alternativt kan du kontrollera att en URI-sträng är giltig genom att anropa IsWellFormedOriginalString() metoden innan du anropar konstruktorn.