Uri.GetComponents(UriComponents, UriFormat) Metódus
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri az aktuális példány megadott összetevőit a speciális karakterekhez megadott meneküléssel.
public:
System::String ^ GetComponents(UriComponents components, UriFormat format);public string GetComponents(UriComponents components, UriFormat format);member this.GetComponents : UriComponents * UriFormat -> stringPublic Function GetComponents (components As UriComponents, format As UriFormat) As StringParaméterek
- components
- UriComponents
Az értékek bitenkénti kombinációja UriComponents , amely meghatározza, hogy az aktuális példány mely részei térjenek vissza a hívóhoz.
- format
- UriFormat
Az egyik számbavételi érték, amely a speciális karakterek kimenekülését szabályozza.
Válaszok
Az aktuális példány összetevői.
Kivételek
components nem érvényes UriComponents értékek kombinációja.
Az áram Uri nem abszolút URI. Ezzel a módszerrel relatív URI-k nem használhatók.
Megjegyzések
A Query, Fragment, Scheme, UserInfo, HostPortés Path összetevők nem tartalmazzák a határolót. A jelzőt (a bitenkénti VAGY operátorral) kombinálhatja KeepDelimiter bármelyik értékkel, hogy lekérje az értéket a határolóval. Az összes többi UriComponents érték és az értékek kombinációi esetében a határolójelek a visszaadott érték részét képezik.
Az összetevők az URI-ban megjelenő sorrendben jelennek meg. Ha például Scheme meg van adva, először megjelenik.
Ha engedélyezve van a nemzetközi erőforrás-azonosító (IRI) és az internationalizált tartománynév (IDN) támogatása, a visszaadott String karakterek száma nő. Az IRI támogatásához használt punycode-nevek csak ASCII-karaktereket tartalmaznak, és mindig az xn előtaggal kezdődnek. Ha engedélyezve van az IRI és az IDN, a unicode helyettesítő karaktereket a GetComponents metódus megfelelően kezeli.
Az IRI támogatásával kapcsolatos további információkért tekintse meg az osztály Megjegyzések szakaszát Uri .
Note
Ha a GetComponents metódus meghívása a következőre Unescaped van format állítva, akkor a visszatérési értéket nem használhatja argumentumként egy Uri konstruktor számára, hogy ezzel egyenértékű Uriértéket hozzon létre.