Uri Konstruktorok

Definíció

Névtér:

System

Szerelvény:

System.dll

Inicializálja a Uri osztály új példányát.

Túlterhelések

Name	Description
Uri(String)	Inicializálja az osztály új példányát a Uri megadott URI-val.
Uri(SerializationInfo, StreamingContext)	Inicializálja az Uri osztály új példányát az és SerializationInfo az StreamingContext osztályok megadott példányaiból.
Uri(String, Boolean)	Elavult. Inicializálja az osztály új példányát a Uri megadott URI-val, a karakteres menekülés explicit vezérlésével.
Uri(String, UriKind)	Inicializálja az osztály új példányát a Uri megadott URI-val. Ez a konstruktor lehetővé teszi annak megadását, hogy az URI-sztring relatív URI- vagy abszolút URI-e, vagy határozatlan.
Uri(Uri, String)	Inicializálja az osztály új példányát a Uri megadott alap URI és relatív URI-sztring alapján.
Uri(Uri, Uri)	Inicializálja az Uri osztály új példányát egy megadott alappéldány Uri és egy relatív Uri példány kombinációja alapján.
Uri(Uri, String, Boolean)	Elavult. Inicializálja az osztály új példányát a Uri megadott alap- és relatív URI-k alapján, a karakteres menekülés explicit vezérlésével.

Uri(String)

Inicializálja az osztály új példányát a Uri megadott URI-val.

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

public Uri(string uriString);

new Uri : string -> Uri

Public Sub New (uriString As String)

Paraméterek

uriString

String

Egy sztring, amely azonosítja a példány által képviselni kívánt erőforrást Uri .

Kivételek

ArgumentNullException

uriString az null.

UriFormatException

Megjegyzés: Az Windows Áruházbeli alkalmazások .NET vagy a Portable Class Library esetében inkább az alaposztály kivételét,FormatException.

uriString üres.

-vagy-

A megadott uriString séma nem megfelelően van formázva. Lásd a(z) CheckSchemeName(String).

-vagy-

uriString túl sok perjelet tartalmaz.

-vagy-

A megadott uriString jelszó, állomásnév, fájlnév vagy felhasználónév érvénytelen.

-vagy-

A megadott uriString állomás- vagy szolgáltatónevet fordított perjelek szakítják meg.

-vagy-

A megadott uriString portszám érvénytelen vagy nem elemezhető.

-vagy-

A uriString hossza meghaladja a 65519 karaktert (csak .NET 9- és korábbi verziókban).

-vagy-

A megadott uriString séma hossza meghaladja az 1023 karaktert.

-vagy-

Érvénytelen karaktersorozat van a fájlban uriString.

-vagy-

A megadott MS-DOS elérési út uriString nem c:\\-val kezdődik.

Példák

Az alábbi példa létrehoz egy példányt Uri az URI-val 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/")

Megjegyzések

Ez a konstruktor létrehoz egy példányt Uri egy URI-sztringből. Elemzi az URI-t, canonical formátumban helyezi el, és minden szükséges menekülési kódolást végrehajt.

Ez a konstruktor nem biztosítja, hogy a Uri hivatkozás akadálymentes erőforrásra hivatkozik.

Ha a uriString cím IPv6-címet jelöl, szögletes zárójelek közé kell tenni, például: "http://[2607:f8b0:400d:c06::69]".

Ez a konstruktor feltételezi, hogy a string paraméter egy abszolút URI-ra hivatkozik, és egyenértékű azzal, hogy a konstruktort UriKind a Uri következőre állítva hívja megAbsolute. Ha a string konstruktornak átadott paraméter relatív URI, ez a konstruktor egy UriFormatException.

Uri(SerializationInfo, StreamingContext)

Inicializálja az Uri osztály új példányát az és SerializationInfo az StreamingContext osztályok megadott példányaiból.

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

Protected Sub New (serializationInfo As SerializationInfo, streamingContext As StreamingContext)

Paraméterek

serializationInfo

SerializationInfo

Az új Uri példány szerializálásához szükséges információk.

streamingContext

StreamingContext

Az új Uri példányhoz társított szerializált stream forrása.

Kivételek

ArgumentNullException

A serializationInfo paraméter URI-t null tartalmaz.

UriFormatException

A serializationInfo paraméter üres URI-t tartalmaz.

-vagy-

A megadott séma nem megfelelően van formázva. Lásd a(z) CheckSchemeName(String).

-vagy-

Az URI túl sok perjelet tartalmaz.

-vagy-

Az URI-ban megadott jelszó, állomásnév, fájlnév vagy felhasználónév érvénytelen.

-vagy-

Az URI-ban megadott állomás- vagy szolgáltatónevet fordított perjelek szakítják meg.

-vagy-

Az URI-ban megadott portszám érvénytelen vagy nem elemezhető.

-vagy-

Az URI hossza meghaladja a 65519 karaktert (csak .NET 9- és korábbi verziókban).

-vagy-

Az URI-ban megadott séma hossza meghaladja az 1023 karaktert.

-vagy-

Érvénytelen karaktersorozat található az URI-ban.

-vagy-

Az URI-ban megadott MS-DOS elérési út nem c:\\-val kezdődik.

Megjegyzések

Ez a konstruktor implementálja az ISerializable osztály felületét Uri .

Lásd még

• XML- és SOAP-szerializálás

Uri(String, Boolean)

Figyelemfelhívás

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

Inicializálja az osztály új példányát a Uri megadott URI-val, a karakteres menekülés explicit vezérlésével.

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

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

Paraméterek

uriString

String

Egy sztring, amely azonosítja a példány által képviselni kívánt erőforrást Uri . Vegye figyelembe, hogy egy sztring formátumú IPv6-címnek szögletes zárójelek közé kell tartoznia. Például: "http://[2607:f8b0:400d:c06::69]".

dontEscape

Boolean

trueha uriString teljesen megmenekült; egyébként. false

Attribútumok

ObsoleteAttribute

Kivételek

ArgumentNullException

uriString az null.

UriFormatException

uriString üres vagy csak szóközöket tartalmaz.

-vagy-

A megadott uriString séma érvénytelen.

-vagy-

uriString túl sok perjelet tartalmaz.

-vagy-

A megadott uriString jelszó, állomásnév, fájlnév vagy felhasználónév érvénytelen.

-vagy-

A megadott uriString állomás- vagy szolgáltatónevet fordított perjelek szakítják meg.

-vagy-

A megadott uriString portszám érvénytelen vagy nem elemezhető.

-vagy-

A uriString hossza meghaladja a 65519 karaktert (csak .NET 9- és korábbi verziókban).

-vagy-

A megadott uriString séma hossza meghaladja az 1023 karaktert.

-vagy-

Érvénytelen karaktersorozat van a fájlban uriString.

-vagy-

A megadott MS-DOS elérési út uriString nem c:\\-val kezdődik.

Megjegyzések

Ez a konstruktor létrehoz egy példányt Uri egy URI-sztringből. Elemzi az URI-t, és canonical formátumban helyezi el.

A dontEscape paraméter azt szabályozza, hogy a fenntartott karakterek feloldósorozatokká legyenek-e lefordítva. Ezt a paramétert true csak akkor kell beállítani, ha biztos abban, hogy az URI összes fenntartott karaktere meg lett szökve. Ha olyan URI-értékre állítja az értéket true , amely nem lett teljesen megszabadulva, váratlan viselkedést okozhat. Erősen ajánlott, hogy ezt a paramétert mindig a következőre falseállítsa.

Ha dontEscape be van állítva false, a konstruktor feloldja a fenntartott karaktereket, és ellenőrzi, hogy a százalék (%) összes előfordulását érvényes feloldási sorozat követi-e. Ha a százalékot követő karaktersorozat érvénytelen, a százalékot %25váltja fel.

Ez a konstruktor nem biztosítja, hogy a Uri hivatkozás akadálymentes erőforrásra hivatkozik.

Uri(String, UriKind)

Inicializálja az osztály új példányát a Uri megadott URI-val. Ez a konstruktor lehetővé teszi annak megadását, hogy az URI-sztring relatív URI- vagy abszolút URI-e, vagy határozatlan.

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éterek

uriString

String

Egy sztring, amely azonosítja a példány által képviselni kívánt erőforrást Uri .

uriKind

UriKind

Megadja, hogy az URI-sztring relatív URI- vagy abszolút URI-e, vagy meghatározatlan.

Kivételek

ArgumentException

uriKind érvénytelen.

ArgumentNullException

uriString az null.

UriFormatException

Megjegyzés: Az Windows Áruházbeli alkalmazások .NET vagy a Portable Class Library esetében inkább az alaposztály kivételét,FormatException.

uriString relatív URI-t tartalmaz, és uriKind az Absolute.

vagy

uriString abszolút URI-t tartalmaz, és uriKind a Relative.

vagy

uriString üres.

-vagy-

A megadott uriString séma nem megfelelően van formázva. Lásd a(z) CheckSchemeName(String).

-vagy-

uriString túl sok perjelet tartalmaz.

-vagy-

A megadott uriString jelszó, állomásnév, fájlnév vagy felhasználónév érvénytelen.

-vagy-

A megadott uriString állomás- vagy szolgáltatónevet fordított perjelek szakítják meg.

-vagy-

A megadott uriString portszám érvénytelen vagy nem elemezhető.

-vagy-

A uriString hossza meghaladja a 65519 karaktert (csak .NET 9- és korábbi verziókban).

-vagy-

A megadott uriString séma hossza meghaladja az 1023 karaktert.

-vagy-

Érvénytelen karaktersorozat van a fájlban uriString.

-vagy-

A megadott MS-DOS elérési út uriString nem c:\\-val kezdődik.

Megjegyzések

A relatív és abszolút URI-k formátuma különböző korlátozásokkal rendelkezik. A relatív URI-k például nem igényelnek sémát vagy hatóságot. A megadott uriKind értéknek meg kell egyeznie a megadott URI típusával uriString. Ha RelativeOrAbsolute azonban meg van adva, az URI-sztring relatív vagy abszolút lehet.

A uriStringsztring formátumú IPv6-címeket zárójelek közé kell foglalni, például: "http://[2607:f8b0:400d:c06::69]".

Uri(Uri, String)

Inicializálja az osztály új példányát a Uri megadott alap URI és relatív URI-sztring alapján.

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)

Paraméterek

baseUri

Uri

Az alap URI.

relativeUri

String

Az alap URI-hoz hozzáadandó relatív URI.

Kivételek

ArgumentNullException

baseUri az null.

ArgumentOutOfRangeException

baseUri nem abszolút Uri példány.

UriFormatException

Megjegyzés: Az Windows Áruházbeli alkalmazások .NET vagy a Portable Class Library esetében inkább az alaposztály kivételét,FormatException.

A kombinálással baseUrirelativeUri létrehozott URI üres vagy csak szóközöket tartalmaz.

-vagy-

Az URI-ban megadott séma összevonással baseUri jön létre, és relativeUri nem érvényes.

-vagy-

Az URI összevonással baseUri jön létre, és relativeUri túl sok perjelet tartalmaz.

-vagy-

Az URI-ban megadott jelszó, gazdagépnév, fájlnév vagy felhasználónév, amely kombinálással baseUri jön létre, és relativeUri érvénytelen.

-vagy-

Az URI-ban megadott állomás- vagy szolgáltatónév összevonással baseUri jön létre, és relativeUri fordított perjelekkel végződik.

-vagy-

Az URI-ban megadott portszám összevonással baseUri jön létre, és relativeUri érvénytelen vagy nem elemezhető.

-vagy-

A baseUri és a relativeUri egyesítésével létrehozott URI hossza meghaladja a 65519 karaktert (csak .NET a 9. és a korábbi verziók esetén).

-vagy-

Az URI-ban megadott séma hossza 1023 karakter összevonásával baseUri és relativeUri meghaladja az 1023 karaktert.

-vagy-

Érvénytelen karaktersorozat van az URI-ban a kombinálással és relativeUria baseUri .

-vagy-

A megadott MS-DOS elérési út baseUri nem c:\\-val kezdődik.

Példák

Az alábbi példa az osztály új példányát hozza létre a Uri relatív URI-k http://www.contoso.com kombinálásával és catalog/shownew.htm az abszolút URI http://www.contoso.com/catalog/shownew.htmlétrehozásához.

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

Megjegyzések

Ez a konstruktor létrehoz egy példányt Uri az és a baseUrirelativeUri. Ha relativeUri abszolút URI (amely egy sémát, állomásnevet és opcionálisan egy portszámot tartalmaz), a Uri példány csak relativeUria használatával jön létre.

Ha a baseUri relatív részek (például /api), akkor a relatív részt perjellel kell lezárni (például /api/), ha a relatív részét baseUri meg kell őrizni a felépítettben Uri.

Ezenkívül, ha a relativeUri perjellel kezdődik, akkor az a baseUri

Ez a konstruktor nem biztosítja, hogy a Uri hivatkozás akadálymentes erőforrásra hivatkozik.

Uri(Uri, Uri)

Inicializálja az Uri osztály új példányát egy megadott alappéldány Uri és egy relatív Uri példány kombinációja alapján.

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éterek

baseUri

Uri

Uri Abszolút érték, amely az új Uri példány alapja.

relativeUri

Uri

Egy relatív Uri példány, amely a következővel baseUrivan kombinálva: .

Kivételek

ArgumentException

baseUri nem abszolút Uri példány.

ArgumentNullException

baseUri az null.

ArgumentOutOfRangeException

baseUri nem abszolút Uri példány.

UriFormatException

Megjegyzés: Az Windows Áruházbeli alkalmazások .NET vagy a Portable Class Library esetében inkább az alaposztály kivételét,FormatException.

A kombinálással baseUrirelativeUri létrehozott URI üres vagy csak szóközöket tartalmaz.

-vagy-

Az URI-ban megadott séma összevonással baseUri jön létre, és relativeUri nem érvényes.

-vagy-

Az URI összevonással baseUri jön létre, és relativeUri túl sok perjelet tartalmaz.

-vagy-

Az URI-ban megadott jelszó, gazdagépnév, fájlnév vagy felhasználónév, amely kombinálással baseUri jön létre, és relativeUri érvénytelen.

-vagy-

Az URI-ban megadott állomás- vagy szolgáltatónév összevonással baseUri jön létre, és relativeUri fordított perjelekkel végződik.

-vagy-

Az URI-ban megadott portszám összevonással baseUri jön létre, és relativeUri érvénytelen vagy nem elemezhető.

-vagy-

A baseUri és a relativeUri egyesítésével létrehozott URI hossza meghaladja a 65519 karaktert (csak .NET a 9. és a korábbi verziók esetén).

-vagy-

Az URI-ban megadott séma hossza 1023 karakter összevonásával baseUri és relativeUri meghaladja az 1023 karaktert.

-vagy-

Érvénytelen karaktersorozat van az URI-ban a kombinálással és relativeUria baseUri .

-vagy-

A megadott MS-DOS elérési út baseUri nem c:\\-val kezdődik.

Példák

Ez a példa egy abszolút Uri példányt és absoluteUriegy relatív Uri példányt relativeUrihoz létre. Ezután létrejön egy új Uri példány combinedUriebből a két példányból.

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

Megjegyzések

Ez a konstruktor létrehoz egy új Uri példányt egy abszolút Uri példány baseUriés egy relatív Uri példány relativeUriegyesítésével. Ha relativeUri abszolút Uri példány (amely egy sémát, állomásnevet és opcionálisan portszámot tartalmaz), a Uri példány csak relativeUria használatával jön létre.

Ha a baseUri relatív részek (például /api), akkor a relatív részt perjellel kell lezárni (például /api/), ha a relatív részét baseUri meg kell őrizni a felépítettben Uri.

Továbbá, ha a relativeUri kezdő egy perjel, akkor a helyébe bármely relatív része a baseUri.

Ez a konstruktor nem biztosítja, hogy a Uri hivatkozás akadálymentes erőforrásra hivatkozik.

Uri(Uri, String, Boolean)

Figyelemfelhívás

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

Inicializálja az osztály új példányát a Uri megadott alap- és relatív URI-k alapján, a karakteres menekülés explicit vezérlésével.

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

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

Paraméterek

baseUri

Uri

Az alap URI.

relativeUri

String

Az alap URI-hoz hozzáadandó relatív URI.

dontEscape

Boolean

trueha baseUri és relativeUri teljesen megmenekült; egyébként. false

Attribútumok

ObsoleteAttribute

Kivételek

ArgumentNullException

baseUri az null.

ArgumentOutOfRangeException

baseUri nem abszolút Uri példány.

UriFormatException

A kombinálással baseUrirelativeUri létrehozott URI üres vagy csak szóközöket tartalmaz.

-vagy-

Az URI-ban megadott séma összevonással baseUri jön létre, és relativeUri nem érvényes.

-vagy-

Az URI összevonással baseUri jön létre, és relativeUri túl sok perjelet tartalmaz.

-vagy-

Az URI-ban megadott jelszó, gazdagépnév, fájlnév vagy felhasználónév, amely kombinálással baseUri jön létre, és relativeUri érvénytelen.

-vagy-

Az URI-ban megadott állomás- vagy szolgáltatónév összevonással baseUri jön létre, és relativeUri fordított perjelekkel végződik.

-vagy-

Az URI-ban megadott portszám összevonással baseUri jön létre, és relativeUri érvénytelen vagy nem elemezhető.

-vagy-

A baseUri és a relativeUri egyesítésével létrehozott URI hossza meghaladja a 65519 karaktert (csak .NET a 9. és a korábbi verziók esetén).

-vagy-

Az URI-ban megadott séma hossza 1023 karakter összevonásával baseUri és relativeUri meghaladja az 1023 karaktert.

-vagy-

Érvénytelen karaktersorozat van az URI-ban a kombinálással és relativeUria baseUri .

-vagy-

A megadott MS-DOS elérési út baseUri nem c:\\-val kezdődik.

Megjegyzések

Ez a konstruktor létrehoz egy példányt Uri az és relativeUria baseUri . Ha az átadott relativeUri URI abszolút URI (amely egy sémát, egy gazdagépnevet és opcionálisan egy portszámot tartalmaz), a Uri példány csak relativeUria használatával jön létre.

A dontEscape paraméter azt szabályozza, hogy a fenntartott karakterek feloldósorozatokká legyenek-e lefordítva. Ezt a paramétert true csak akkor kell beállítani, ha biztos abban, hogy az URI összes fenntartott karaktere meg lett szökve. Ha olyan URI-értékre állítja az értéket true , amely nem lett teljesen megszabadulva, váratlan viselkedést okozhat. Erősen ajánlott, hogy ezt a paramétert mindig a következőre falseállítsa. Ha dontEscape be van állítva false, a konstruktor feloldja a fenntartott karaktereket, és ellenőrzi, hogy a százalék (%) összes előfordulását érvényes feloldási sorozat követi-e. Ha a százalékot követő karaktersorozat érvénytelen, a százalékot %25váltja fel.

Ez a konstruktor nem biztosítja, hogy a Uri hivatkozás akadálymentes erőforrásra hivatkozik.

Megjegyzések a hívókhoz

Biztonsági problémák miatt az alkalmazás nem hívhatja meg ezt a konstruktort nem megbízható forrásokból származó URI-sztringekkeldontEscape, és a beállítás értéke.true Másik lehetőségként a konstruktor meghívása előtt a metódus meghívásával ellenőrizheti az IsWellFormedOriginalString() URI-sztring érvényességét.