Uri Uri Uri Uri Class

Definition

Stellt eine Objektdarstellung eines URIs (Uniform Resource Identifier) und einfachen Zugriff auf die Teile des URIs bereit. Provides an object representation of a uniform resource identifier (URI) and easy access to the parts of the URI.

public ref class Uri : System::Runtime::Serialization::ISerializable
[System.ComponentModel.TypeConverter(typeof(System.UriTypeConverter))]
[Serializable]
public class Uri : System.Runtime.Serialization.ISerializable
type Uri = class
    interface ISerializable
Public Class Uri
Implements ISerializable
Vererbung
Attribute
TypeConverterAttribute SerializableAttribute
Implementiert

Beispiele

Das folgende Beispiel erstellt eine Instanz von der Uri Klasse und verwendet es zum Erstellen einer WebRequest Instanz.The following example creates an instance of the Uri class and uses it to create a WebRequest instance.

Uri^ siteUri = gcnew Uri( "http://www.contoso.com/" );
WebRequest^ wr = WebRequest::Create( siteUri );
Uri siteUri = new Uri("http://www.contoso.com/");
 
WebRequest wr = WebRequest.Create(siteUri);

Dim siteUri As New Uri("http://www.contoso.com/")
        
Dim wr As WebRequest = WebRequest.Create(siteUri)

Hinweise

Ein URI ist eine kompakte Darstellung einer Ressource für Ihre Anwendung sich im Intranet oder Internet verfügbar.A URI is a compact representation of a resource available to your application on the intranet or Internet. Die Uri -Klasse definiert die Eigenschaften und Methoden für die Behandlung von Analyse, vergleichen und Kombinieren von URIs.The Uri class defines the properties and methods for handling URIs, including parsing, comparing, and combining. Die Uri Eigenschaften der Klasse schreibgeschützt sind; verwenden Sie zum Erstellen eines änderbaren-Objekts, das UriBuilder Klasse.The Uri class properties are read-only; to create a modifiable object, use the UriBuilder class.

Relative URIs (z. B. "/ /New/Index.htm") muss in Bezug auf die Basis-URI erweitert werden, damit sie absolut sind.Relative URIs (for example, "/new/index.htm") must be expanded with respect to a base URI so that they are absolute. Die MakeRelative Methode wird bereitgestellt, um absolute URIs zu relativen URIs, die bei Bedarf zu konvertieren.The MakeRelative method is provided to convert absolute URIs to relative URIs when necessary.

Die Uri Konstruktoren nicht mit einem Escapezeichen URI-Zeichenfolgen, die Zeichenfolge ist kein ordnungsgemäß formatierter URI einschließlich Schemabezeichner.The Uri constructors do not escape URI strings if the string is a well-formed URI including a scheme identifier.

Die Uri Eigenschaften geben eine kanonische datendarstellung zurück, mit Escapezeichen der Codierung mit allen Zeichen mit Unicode-Werten, die größer als 127, die durch die entsprechenden Hexadezimalwerte ersetzt.The Uri properties return a canonical data representation in escaped encoding, with all characters with Unicode values greater than 127 replaced with their hexadecimal equivalents. Den URI in kanonische Form Einfügen der Uri Konstruktor führt die folgenden Schritte aus:To put the URI in canonical form, the Uri constructor performs the following steps:

  • Das URI-Schema konvertiert in Kleinbuchstaben.Converts the URI scheme to lowercase.

  • Konvertiert den Namen des Hosts in Kleinbuchstaben.Converts the host name to lowercase.

  • Wenn der Hostname eine IPv6-Adresse ist, wird die kanonische IPv6-Adresse verwendet.If the host name is an IPv6 address, the canonical IPv6 address is used. ' ScopeId ' und andere optionalen IPv6-Daten werden entfernt.ScopeId and other optional IPv6 data are removed.

  • Entfernt Standard und leere Portnummern.Removes default and empty port numbers.

  • Escapezeichen (auch bekannt als Prozentwert codiert Oktette), die einen reservierten Zweck haben werden decodiert (auch bekannt als wird entfernt).Escaped characters (also known as percent-encoded octets) that don't have a reserved purpose are decoded (also known as being unescaped). Diese nicht reservierten Zeichen sind Großbuchstaben und Kleinbuchstaben (% 41 % 5A "und" 61 % 7A), Dezimalstellen (30-% 39), Bindestrich (% 2D), Punkt (% 2E), Unterstrich (% 5F) und die Tilde (% 7E).These unreserved characters include uppercase and lowercase letters (%41-%5A and %61-%7A), decimal digits (%30-%39), hyphen (%2D), period (%2E), underscore (%5F), and tilde (%7E).

  • Kanonisiert den Pfad für hierarchische URIs indem Sequenzen wie z. B. /. / /... /- und / / (unabhängig davon, ob die Sequenz wird mit Escapezeichen versehen).Canonicalizes the path for hierarchical URIs by compacting sequences such as /./, /../, and // (whether or not the sequence is escaped). Beachten Sie, dass einige Schemas, die für die diese Sequenzen nicht komprimiert werden.Note that there are some schemes for which these sequences are not compacted.

  • Für hierarchische URIs Wenn der Host nicht beendet wird, mit einem Schrägstrich (/), wird eines hinzugefügt.For hierarchical URIs, if the host is not terminated with a forward slash (/), one is added.

  • Standardmäßig werden im URI reservierten Zeichen in Übereinstimmung mit RFC 2396 mit Escapezeichen versehen.By default, any reserved characters in the URI are escaped in accordance with RFC 2396. Dieses Verhalten ändert sich, wenn International Resource Identifiers "oder" internationale Domänenname Analyse die Groß-/Kleinschreibung reservierten Zeichen im URI aktiviert ist werden in Übereinstimmung mit RFC 3986 und RFC 3987 mit Escapezeichen versehen.This behavior changes if International Resource Identifiers or International Domain Name parsing is enabled in which case reserved characters in the URI are escaped in accordance with RFC 3986 and RFC 3987.

Als Teil der Kanonisierung im Konstruktor für einige Schemas, Punkt-zu-Segmente und leere Segmente (/. / /... /- und / /), werden komprimiert (das heißt, sie werden entfernt).As part of canonicalization in the constructor for some schemes, dot-segments and empty segments (/./, /../, and //) are compacted (in other words, they are removed). Die Schemas für die URI diese Sequenzen komprimiert, sind http, Https, Tcp, net.pipe und net.tcp.The schemes for which URI will compact these sequences include http, https, tcp, net.pipe, and net.tcp. Bei einigen anderen Schemas werden diese Sequenzen nicht komprimiert.For some other schemes, these sequences are not compacted. Hier ist, wie diese durch das Komprimieren in der Praxis aussieht.Here's how this compacting looks in practice.

var uri = new Uri("http://myUrl/../.."); // http scheme, unescaped
OR
var uri = new Uri("http://myUrl/%2E%2E/%2E%2E"); // http scheme, escaped
OR
var uri = new Uri("ftp://myUrl/../.."); // ftp scheme, unescaped
OR
var uri = new Uri("ftp://myUrl/%2E%2E/%2E%2E"); // ftp scheme, escaped

Console.WriteLine(uri.AbsoluteUri);  
Console.WriteLine(uri.PathAndQuery);  

Wenn dieser Code ausgeführt wird, wird die folgende Ausgabe, mit dem Escapezeichen Sequenzen ohne Escapezeichen, falls erforderlich, und klicken Sie dann komprimiert zurückgegeben.When this code is executed, it returns the following output, with the escaped sequences unescaped if necessary and then compacted.

http://myUrl/  
/  

Sie können den Inhalt der Transformieren der Uri Klasse durch einen Escapezeichen codierten URI-Verweis auf einen lesbaren URI mithilfe der ToString Methode.You can transform the contents of the Uri class from an escape encoded URI reference to a readable URI reference by using the ToString method. Beachten Sie, die einige reservierten Zeichen möglicherweise noch in der Ausgabe mit Escapezeichen versehen werden die ToString Methode.Note that some reserved characters might still be escaped in the output of the ToString method. Dieser dient zur Unterstützung von eindeutig Rekonstruktion eines URIS aus den Rückgabewert von ToString.This is to support unambiguous reconstruction of a URI from the value returned by ToString.

Einige URIs enthalten einen Fragmentbezeichner, eine Abfrage oder beides.Some URIs include a fragment identifier or a query or both. Ein Fragmentbezeichner ist jeder Text, der folgt ein Nummernzeichen (#), einschließlich der nicht die Nummernzeichen; der Fragmenttext befindet sich in der Fragment Eigenschaft.A fragment identifier is any text that follows a number sign (#), not including the number sign; the fragment text is stored in the Fragment property. Abfrageinformationen ist jeder Text, der ein Fragezeichen (?) im URI folgt. Text der Abfrage befindet sich in der Query Eigenschaft.Query information is any text that follows a question mark (?) in the URI; the query text is stored in the Query property.

In .NET Framework, Version 1.1, wenn die Zeichenfolge, die für einen Konstruktor angegebene ein unbekanntes Schema enthält und "c:\", der Uri-Klasse fügt "/ /" nach dem Doppelpunkt.In the .NET Framework version 1.1, if the string specified to a constructor contains an unknown scheme and "c:\", the Uri class inserts "//" after the colon. Z. B. der URI xyz:c:\abc in konvertiert xyz://c:/abc.For example, the URI xyz:c:\abc is converted to xyz://c:/abc. In .NET Framework, Version 2.0, dieses Verhalten wurde entfernt, und die Beispielzeichenfolge wird in konvertiert xyz:c:/abc.In the .NET Framework version 2.0, this behavior has been removed, and the example string is converted to xyz:c:/abc.

Hinweis

Die URI-Klasse unterstützt die Verwendung von IP-Adressen in beiden Quad-Notation für IPv4-Protokoll und Doppelpunkt getrennten Hexadezimalformat für IPv6-Protokoll.The URI class supports the use of IP addresses in both quad-notation for IPv4 protocol and colon-hexadecimal for IPv6 protocol. Denken Sie daran, schließen Sie die IPv6-Adresse in eckige Klammern, wie http://[::1].Remember to enclose the IPv6 address in square brackets, as in http://[::1].

International Resource Identifier-UnterstützungInternational Resource Identifier Support

Webadressen werden in der Regel mithilfe von uniform Resource Identifier, die aus einem sehr eingeschränkten Satz von Zeichen bestehen ausgedrückt:Web addresses are typically expressed using uniform resource identifiers that consist of a very restricted set of characters:

  • ASCII-Großbuchstaben und -Kleinbuchstaben des englischen AlphabetsUpper and lower case ASCII letters from the English alphabet.

  • Ziffern von 0 bis 9Digits from 0 to 9.

  • einer kleinen Anzahl weiterer ASCII-SymboleA small number of other ASCII symbols.

URI-Spezifikationen werden in RFC 2396, RFC 2732, RFC 3986 und RFC 3987, die von der Internet Engineering Task Force (IETF) veröffentlicht dokumentiert.The specifications for URIs are documented in RFC 2396, RFC 2732, RFC 3986, and RFC 3987 published by the Internet Engineering Task Force (IETF).

Durch das ständige Wachstum des Internets wird es immer notwendiger, Ressourcen in anderen Sprachen als in Englisch zu bezeichnen.With the growth of the Internet, there is a growing need to identify resources using languages other than English. Bezeichner, die dies ermöglichen und die Nicht-ASCII-Zeichen (Zeichen des Unicode-/ISO-Zeichensatzes 10646) zulassen, werden als International Resource Identifiers (IRIs) bezeichnet.Identifiers which facilitate this need and allow non-ASCII characters (characters in the Unicode/ISO 10646 character set) are known as International Resource Identifiers (IRIs). Die IRI-Spezifikationen werden in RFC 3987 dokumentiert, die von der IETF veröffentlicht wird.The specifications for IRIs are documented in RFC 3987 published by IETF. Wenn IRIs verwendet werden, kann eine URL Unicode-Zeichen enthalten.Using IRIs allows a URL to contain Unicode characters.

Die vorhandene Uri -Klasse wurde erweitert, in .NET Framework 3.5, 3.0 SP1 und 2.0 SP1 bereitstellen, Unterstützung von IRI basierend auf RFC 3987.The existing Uri class has been extended in .NET Framework v3.5, 3.0 SP1, and 2.0 SP1 to provide IRI support based on RFC 3987. Benutzer von .NET Framework-Versionen vor Version 4.5 werden keine Änderung gegenüber dem .NET Framework 2.0-Verhalten feststellen, es sei denn, sie IRI wird explizit aktiviert.Users of .NET Framework versions before version 4.5 will not see any change from the .NET Framework 2.0 behavior unless they specifically enable IRI. Dadurch wird die Anwendungskompatibilität mit früheren Versionen von .NET Framework garantiert.This ensures application compatibility with prior versions of the .NET Framework.

Um die IRI-Unterstützung aktivieren, muss die folgende Änderung:To enable support for IRI, the following change is required:

  • Geben Sie, ob Sie möchten, dass Internationalized Domain Name (IDN) zu analysieren, die für den Domänennamen angewendet und gibt an, ob die IRI-Analyseregeln angewendet werden soll.Specify whether you want Internationalized Domain Name (IDN) parsing applied to the domain name and whether IRI parsing rules should be applied. Dies kann erfolgen der "Machine.config" oder in der "App.config" Datei.This can be done in the machine.config or in the app.config file. Fügen Sie beispielsweise Folgendes hinzu:For example, add the following:

    <configuration>  
      <uri>  
      <idn enabled="All" />  
      <iriParsing enabled="true" />  
      </uri>  
    </configuration>  
    

Benutzer von .NET Framework 4.5 und höher haben immer die IRI aktiviert.Users of .NET Framework 4.5 and newer always have IRI enabled. IRI-Analyse kann nicht geändert werden mithilfe einer config Datei.IRI parsing cannot be changed using a .config file.

Beim Aktivieren von IDN werden alle Unicode-Bezeichnungen in einem Domänennamen in ihre Punycode-Entsprechungen konvertiert.Enabling IDN will convert all Unicode labels in a domain name to their Punycode equivalents. Punycode-Namen enthalten nur ASCII-Zeichen und beginnen immer mit dem Präfix „xn--“.Punycode names contain only ASCII characters and always start with the xn-- prefix. So werden vorhandene DNS-Server im Internet unterstützt, da die meisten DNS-Server nur ASCII-Zeichen unterstützen (siehe RFC 3940).The reason for this is to support existing DNS servers on the Internet, since most DNS servers only support ASCII characters (see RFC 3940).

Das Aktivieren von IRI und IDN wirkt sich auf den Wert der Eigenschaft Uri.DnsSafeHost aus.Enabling IRI and IDN affects the value of the Uri.DnsSafeHost property. Das Aktivieren von IRI und IDN kann auch das Verhalten der Methoden Equals, OriginalString, GetComponents und IsWellFormedOriginalString verändern.Enabling IRI and IDN can also change the behavior of the Equals, OriginalString, GetComponents, and IsWellFormedOriginalString methods.

Es gibt drei mögliche Werte für IDN, die abhängig von den DNS-Servern, die verwendet werden:There are three possible values for IDN depending on the DNS servers that are used:

  • IDN aktiviert = Allidn enabled = All

    Durch diesen Wert werden alle Unicode-Domänennamen in ihre Punycode-Entsprechungen (IDN-Namen) konvertiert.This value will convert any Unicode domain names to their Punycode equivalents (IDN names).

  • IDN aktiviert = AllExceptIntranetidn enabled = AllExceptIntranet

    Diesen Wert werden alle Unicode-Domänennamen nicht auf dem lokalen Intranet verwenden Sie die Punycode-Entsprechungen (IDN-Namen) konvertiert.This value will convert all Unicode domain names not on the local Intranet to use the Punycode equivalents (IDN names). In diesem Fall sollte Wenn internationale Namen im lokalen Intranet verarbeitet, unterstützen die DNS-Server, die für das Intranet verwendet werden Unicode-namensauflösung.In this case to handle international names on the local Intranet, the DNS servers that are used for the Intranet should support Unicode name resolution.

  • IDN aktiviert = keineidn enabled = None

    Durch diesen Wert werden keine Unicode-Domänennamen in ihre Punycode-Entsprechungen konvertiert.This value will not convert any Unicode domain names to use Punycode. Dies ist der Standardwert, der das .NET Framework 2.0-Verhalten entspricht.This is the default value which is consistent with the .NET Framework 2.0 behaviour.

Wenn die IRI-Analyse aktiviert ist (IriParsing aktiviert = true) Normalisierung und zeichenüberprüfung gemäß den neuesten IRI-Regeln in RFC 3986 und RFC 3987 ausgeführt werden.When IRI parsing is enabled (iriParsing enabled = true) normalization and character checking are done according to the latest IRI rules in RFC 3986 and RFC 3987. Wenn die IRI-Analyse deaktiviert ist, werden Normalisierung und zeichenüberprüfung gemäß RFC 2396 und RFC 2732 (für IPv6-Literale) ausgeführt.When IRI parsing is disabled, normalization and character checking are performed according to RFC 2396 and RFC 2732 (for IPv6 literals). In Versionen von .NET Framework vor Version 4.5, der Standardwert ist false.In versions of the .NET Framework before version 4.5, the default value is false. In .NET Framework Version 4.5 und höher, der Standardwert ist true, und der aktivierte Zustand der IRI-Analyse kann nicht geändert werden, durch Einstellungen in einem config Datei.In .NET Framework version 4.5 and newer, the default value is true, and the enabled state of IRI parsing cannot be modified by settings in a .config file.

IRI und IDN-Verarbeitung in die Uri Klasse kann auch mithilfe von gesteuert werden die System.Configuration.IriParsingElement, System.Configuration.IdnElement, und System.Configuration.UriSection Konfigurationseinstellungsklassen.IRI and IDN processing in the Uri class can also be controlled using the System.Configuration.IriParsingElement, System.Configuration.IdnElement, and System.Configuration.UriSection configuration setting classes. Die Einstellung System.Configuration.IriParsingElement aktiviert oder deaktiviert die IRI-Verarbeitung in der Klasse Uri.The System.Configuration.IriParsingElement setting enables or disables IRI processing in the Uri class. Die Einstellung System.Configuration.IdnElement aktiviert oder deaktiviert die IDN-Verarbeitung in der Klasse Uri.The System.Configuration.IdnElement setting enables or disables IDN processing in the Uri class. Die Einstellung System.Configuration.IriParsingElement steuert indirekt auch IDN.The System.Configuration.IriParsingElement setting also indirectly controls IDN. Die IRI-Verarbeitung muss aktiviert werden, damit die IDN-Verarbeitung überhaupt möglich ist.IRI processing must be enabled for IDN processing to be possible. Ist die IRI-Verarbeitung deaktiviert, wird die IDN-Verarbeitung auf die Standardeinstellung festgelegt. Darin wird aus Kompatibilitätsgründen das .NET Framework 2.0-Verhalten verwendet, und IDN-Namen werden nicht verwendet.If IRI processing is disabled, then IDN processing will be set to the default setting where the .NET Framework 2.0 behavior is used for compatibility and IDN names are not used.

Die Konfigurationseinstellung für die System.Configuration.IriParsingElement und System.Configuration.IdnElement gelesen wird einmal beim ersten System.Uri Klasse erstellt wird.The configuration setting for the System.Configuration.IriParsingElement and System.Configuration.IdnElement will be read once when the first System.Uri class is constructed. Später vorgenommene Änderungen an den Konfigurationseinstellungen werden anschließend ignoriert.Changes to configuration settings after that time are ignored.

Die Klasse System.GenericUriParser wurde ebenfalls erweitert, um das Erstellen eines anpassbaren Parsers zu ermöglichen, der IRI und IDN unterstützt.The System.GenericUriParser class has also been extended to allow creating a customizable parser that supports IRI and IDN. Das Verhalten eines System.GenericUriParser-Objekts wird durch Übergabe einer bitweisen Kombination von Werten angegeben, die in der System.GenericUriParserOptions-Enumeration des System.GenericUriParser-Konstruktors verfügbar sind.The behavior of a System.GenericUriParser object is specified by passing a bitwise combination of the values available in the System.GenericUriParserOptions enumeration to the System.GenericUriParser constructor. Der GenericUriParserOptions.IriParsing-Typ gibt an, dass der Parser die in RFC 3987 angegebenen Analyseregeln für International Resource Identifiers (IRI) unterstützt.The GenericUriParserOptions.IriParsing type indicates the parser supports the parsing rules specified in RFC 3987 for International Resource Identifiers (IRI). Ob IRI verwendet wird, wird durch die zuvor beschriebenen vorgegeben.Whether IRI is used is dictated by the configuration values previously discussed.

Der GenericUriParserOptions.Idn-Typ gibt an, dass der Parser die IDN-Analyse von Hostnamen unterstützt.The GenericUriParserOptions.Idn type indicates the parser supports Internationalized Domain Name (IDN) parsing (IDN) of host names. Ob IDN verwendet wird, wird durch die zuvor beschriebenen vorgegeben.Whether IDN is used is dictated by the configuration values previously discussed.

Überlegungen zur LeistungPerformance Considerations

Bei Verwendung einer *Web.config *-Datei mit URIs zum Initialisieren der Anwendungen, die zusätzlichen Zeit ist erforderlich, um die URIs zu verarbeiten, wenn ihre Schemabezeichnern nicht dem Standard entsprechende sind.If you use a *Web.config *file that contains URIs to initialize your application, additional time is required to process the URIs if their scheme identifiers are nonstandard. Initialisieren Sie in diesem Fall die betroffenen Teile der Anwendung ein, wenn die URIs benötigt werden, nicht zur Startzeit ausgeführt.In such a case, initialize the affected parts of your application when the URIs are needed, not at start time.

Hinweise für Aufrufer

Aus Sicherheitsgründen wird empfohlen, Ihre Anwendung sollte vorsichtig, wenn akzeptieren Uri Instanzen von nicht vertrauenswürdigen Quellen und mit dontEscape festgelegt true. Sehen Sie eine URI-Zeichenfolge auf Gültigkeit durch Aufrufen der IsWellFormedOriginalString() Methode. Because of security concerns, your application should use caution when accepting Uri instances from untrusted sources and with dontEscape set to true.You can check a URI string for validity by calling the IsWellFormedOriginalString() method.

Konstruktoren

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

Initialisiert eine neue Instanz der Uri-Klasse aus den angegebenen Instanzen der SerializationInfo-Klasse und der StreamingContext-Klasse. Initializes a new instance of the Uri class from the specified instances of the SerializationInfo and StreamingContext classes.

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

Initialisiert eine neue Instanz der Uri-Klasse mit dem angegebenen URI. Initializes a new instance of the Uri class with the specified URI.

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

Initialisiert eine neue Instanz der Uri-Klasse mit dem angegebenen URI, wobei die Verwendung der Escapezeichen explizit gesteuert werden kann. 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) Uri(String, UriKind)

Initialisiert eine neue Instanz der Uri-Klasse mit dem angegebenen URI. Initializes a new instance of the Uri class with the specified URI. Mit diesem Konstruktor können Sie angeben, ob die URI-Zeichenfolge ein relativer URI, ein absoluter URI oder unbestimmt ist. 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)

Initialisiert eine neue Instanz der Uri-Klasse auf Grundlage des angegebenen Basis-URIs und der relativen URI-Zeichenfolge. Initializes a new instance of the Uri class based on the specified base URI and relative URI string.

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

Initialisiert eine neue Instanz der Uri-Klasse auf Grundlage des angegebenen Basis-URIs und des angegebenen relativen URIs mit expliziter Steuerung der Escapesequenzen. Initializes a new instance of the Uri class based on the specified base and relative URIs, with explicit control of character escaping.

Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri) Uri(Uri, Uri)

Initialisiert eine neue Instanz der Uri-Klasse auf Grundlage der Kombination einer angegebenen Uri-Instanz als Basis und einer relativen Uri-Instanz. Initializes a new instance of the Uri class based on the combination of a specified base Uri instance and a relative Uri instance.

Felder

SchemeDelimiter SchemeDelimiter SchemeDelimiter SchemeDelimiter

Gibt die Zeichen an, die das Schema des Kommunikationsprotokolls vom Adressteil des URIs trennen. Specifies the characters that separate the communication protocol scheme from the address portion of the URI. Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeFile UriSchemeFile UriSchemeFile UriSchemeFile

Gibt an, dass der URI ein Zeiger auf eine Datei ist. Specifies that the URI is a pointer to a file. Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeFtp UriSchemeFtp UriSchemeFtp UriSchemeFtp

Gibt an, dass auf den URI über FTP (File Transfer Protocol) zugegriffen wird. Specifies that the URI is accessed through the File Transfer Protocol (FTP). Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeGopher UriSchemeGopher UriSchemeGopher UriSchemeGopher

Gibt an, dass auf den URI über das Gopher-Protokoll zugegriffen wird. Specifies that the URI is accessed through the Gopher protocol. Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeHttp UriSchemeHttp UriSchemeHttp UriSchemeHttp

Gibt an, dass auf den URI über HTTP (Hypertext Transfer Protocol) zugegriffen wird. Specifies that the URI is accessed through the Hypertext Transfer Protocol (HTTP). Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeHttps UriSchemeHttps UriSchemeHttps UriSchemeHttps

Gibt an, dass auf den URI über HTTPS (Secure Hypertext Transfer Protocol) zugegriffen wird. Specifies that the URI is accessed through the Secure Hypertext Transfer Protocol (HTTPS). Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeMailto UriSchemeMailto UriSchemeMailto UriSchemeMailto

Gibt an, dass der URI eine E-Mail-Adresse ist und der Zugriff über SMTP (Simple Mail Transport Protocol) erfolgt. Specifies that the URI is an email address and is accessed through the Simple Mail Transport Protocol (SMTP). Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeNetPipe UriSchemeNetPipe UriSchemeNetPipe UriSchemeNetPipe

Gibt an, dass auf den URI über das von Windows Communication Foundation (WCF) verwendete NetPipe-Schema zugegriffen wird. Specifies that the URI is accessed through the NetPipe scheme used by Windows Communication Foundation (WCF). Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeNetTcp UriSchemeNetTcp UriSchemeNetTcp UriSchemeNetTcp

Gibt an, dass auf den URI über das von Windows Communication Foundation (WCF) verwendete NetTcp-Schema zugegriffen wird. Specifies that the URI is accessed through the NetTcp scheme used by Windows Communication Foundation (WCF). Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeNews UriSchemeNews UriSchemeNews UriSchemeNews

Gibt an, dass der URI eine Internetnewsgroup ist, auf die über NNTP (Network News Transport Protocol) zugegriffen wird. Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). Dieses Feld ist schreibgeschützt. This field is read-only.

UriSchemeNntp UriSchemeNntp UriSchemeNntp UriSchemeNntp

Gibt an, dass der URI eine Internetnewsgroup ist, auf die über NNTP (Network News Transport Protocol) zugegriffen wird. Specifies that the URI is an Internet news group and is accessed through the Network News Transport Protocol (NNTP). Dieses Feld ist schreibgeschützt. This field is read-only.

Eigenschaften

AbsolutePath AbsolutePath AbsolutePath AbsolutePath

Ruft den absoluten Pfad des URIs ab. Gets the absolute path of the URI.

AbsoluteUri AbsoluteUri AbsoluteUri AbsoluteUri

Ruft den absoluten URI ab. Gets the absolute URI.

Authority Authority Authority Authority

Ruft den DNS-Hostnamen (Domain Name System) oder die IP-Adresse und die Anschlussnummer für einen Server ab. Gets the Domain Name System (DNS) host name or IP address and the port number for a server.

DnsSafeHost DnsSafeHost DnsSafeHost DnsSafeHost

Ruft einen Hostnamen, der sicher für die DNS-Auflösung verwendet werden kann, da er keine Escapezeichen enthält. Gets a host name that, after being unescaped if necessary, is safe to use for DNS resolution.

Fragment Fragment Fragment Fragment

Ruft das mit Escapezeichen versehene URI-Fragment ab. Gets the escaped URI fragment.

Host Host Host Host

Ruft die Hostkomponente dieser Instanz ab. Gets the host component of this instance.

HostNameType HostNameType HostNameType HostNameType

Ruft den Typ des im URI angegebenen Hostnamens ab. Gets the type of the host name specified in the URI.

IdnHost IdnHost IdnHost IdnHost

Der zu RFC 3490 kompatible IDN (Internationale Domänenname) des Hosts, wofür ggf. Punycode verwendet wird. The RFC 3490 compliant International Domain Name of the host, using Punycode as appropriate. Diese Zeichenfolge kann sicher für die DNS-Auflösung verwendet werden, da sie keine Escapezeichen enthält. This string, after being unescaped if necessary, is safe to use for DNS resolution.

IsAbsoluteUri IsAbsoluteUri IsAbsoluteUri IsAbsoluteUri

Ruft ab, ob die Uri-Instanz absolut ist. Gets whether the Uri instance is absolute.

IsDefaultPort IsDefaultPort IsDefaultPort IsDefaultPort

Ruft ab, ob der Portwert im URI der Standardwert für dieses Schema ist. Gets whether the port value of the URI is the default for this scheme.

IsFile IsFile IsFile IsFile

Ruft einen Wert ab, der angibt, ob der angegebene Uri ein Datei-URI ist. Gets a value indicating whether the specified Uri is a file URI.

IsLoopback IsLoopback IsLoopback IsLoopback

Ruft ab, ob der angegebene Uri auf den lokalen Host verweist. Gets whether the specified Uri references the local host.

IsUnc IsUnc IsUnc IsUnc

Ruft ab, ob der angegebene Uri einen UNC-Pfad (Universal Naming Convention) darstellt. Gets whether the specified Uri is a universal naming convention (UNC) path.

LocalPath LocalPath LocalPath LocalPath

Ruft die Darstellung eines Dateinamens im lokalen Betriebssystem ab. Gets a local operating-system representation of a file name.

OriginalString OriginalString OriginalString OriginalString

Ruft die ursprüngliche URI-Zeichenfolge ab, die an den Uri-Konstruktor übergeben wurde. Gets the original URI string that was passed to the Uri constructor.

PathAndQuery PathAndQuery PathAndQuery PathAndQuery

Ruft die durch ein Fragezeichen (?) getrennten Werte der AbsolutePath-Eigenschaft und der Query-Eigenschaft ab. Gets the AbsolutePath and Query properties separated by a question mark (?).

Port Port Port Port

Ruft die Anschlussnummer dieses URIs ab. Gets the port number of this URI.

Query Query Query Query

Ruft im angegebenen URI enthaltene Abfrageinformationen ab. Gets any query information included in the specified URI.

Scheme Scheme Scheme Scheme

Ruft den Namen des Schemas für diesen URI ab. Gets the scheme name for this URI.

Segments Segments Segments Segments

Ruft ein Array mit den Pfadsegmenten ab, aus denen sich der angegebene URI zusammensetzt. Gets an array containing the path segments that make up the specified URI.

UserEscaped UserEscaped UserEscaped UserEscaped

Gibt an, dass die URI-Zeichenfolge vor dem Erstellen der Uri-Instanz vollständig mit Escapezeichen versehen war. Indicates that the URI string was completely escaped before the Uri instance was created.

UserInfo UserInfo UserInfo UserInfo

Ruft Benutzernamen, Kennwort oder weitere benutzerspezifische Informationen ab, die dem angegebenen URI zugeordnet sind. Gets the user name, password, or other user-specific information associated with the specified URI.

Methoden

Canonicalize() Canonicalize() Canonicalize() Canonicalize()

Konvertiert den intern gespeicherten URI in kanonische Form. Converts the internally stored URI to canonical form.

CheckHostName(String) CheckHostName(String) CheckHostName(String) CheckHostName(String)

Bestimmt, ob der angegebene Hostname ein gültiger DNS-Name ist. Determines whether the specified host name is a valid DNS name.

CheckSchemeName(String) CheckSchemeName(String) CheckSchemeName(String) CheckSchemeName(String)

Bestimmt, ob der angegebene Schemaname gültig ist. Determines whether the specified scheme name is valid.

CheckSecurity() CheckSecurity() CheckSecurity() CheckSecurity()

Das Aufrufen dieser Methode hat keine Auswirkung. Calling this method has no effect.

Compare(Uri, Uri, UriComponents, UriFormat, StringComparison) Compare(Uri, Uri, UriComponents, UriFormat, StringComparison) Compare(Uri, Uri, UriComponents, UriFormat, StringComparison) Compare(Uri, Uri, UriComponents, UriFormat, StringComparison)

Vergleicht die angegebenen Teile von zwei URIs gemäß den angegebenen Vergleichsregeln. Compares the specified parts of two URIs using the specified comparison rules.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

Erstellt ein Objekt mit allen relevanten Informationen, die zum Generieren eines Proxys für die Kommunikation mit einem Remoteobjekt erforderlich sind. Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Überprüft zwei Uri-Instanzen auf Gleichheit. Compares two Uri instances for equality.

Escape() Escape() Escape() Escape()

Konvertiert alle unsicheren oder reservierten Zeichen in der Pfadkomponente in die entsprechenden Hexadezimaldarstellungen. Converts any unsafe or reserved characters in the path component to their hexadecimal character representations.

EscapeDataString(String) EscapeDataString(String) EscapeDataString(String) EscapeDataString(String)

Konvertiert eine Zeichenfolge in eine Darstellung mit Escapezeichen. Converts a string to its escaped representation.

EscapeString(String) EscapeString(String) EscapeString(String) EscapeString(String)

Konvertiert eine Zeichenfolge in eine Darstellung mit Escapezeichen. Converts a string to its escaped representation.

EscapeUriString(String) EscapeUriString(String) EscapeUriString(String) EscapeUriString(String)

Konvertiert eine URI-Zeichenfolge in eine Darstellung mit Escapezeichen. Converts a URI string to its escaped representation.

FromHex(Char) FromHex(Char) FromHex(Char) FromHex(Char)

Ruft den Dezimalwert einer Hexadezimalziffer ab. Gets the decimal value of a hexadecimal digit.

GetComponents(UriComponents, UriFormat) GetComponents(UriComponents, UriFormat) GetComponents(UriComponents, UriFormat) GetComponents(UriComponents, UriFormat)

Ruft die angegebenen Komponenten der aktuellen Instanz mit dem angegebenen Escapeverhalten für Sonderzeichen ab. Gets the specified components of the current instance using the specified escaping for special characters.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Ruft den Hashcode für den URI ab. Gets the hash code for the URI.

GetLeftPart(UriPartial) GetLeftPart(UriPartial) GetLeftPart(UriPartial) GetLeftPart(UriPartial)

Ruft den angegebenen Teil einer Uri-Instanz ab. Gets the specified portion of a Uri instance.

GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

Ruft das aktuelle Lebensdauerdienstobjekt ab, das die Lebensdauerrichtlinien für diese Instanz steuert. Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Gibt die Daten zurück, die zum Serialisieren der aktuellen Instanz benötigt werden. Returns the data needed to serialize the current instance.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab. Gets the Type of the current instance.

(Inherited from Object)
HexEscape(Char) HexEscape(Char) HexEscape(Char) HexEscape(Char)

Konvertiert ein angegebenes Zeichen in die entsprechende Hexadezimaldarstellung. Converts a specified character into its hexadecimal equivalent.

HexUnescape(String, Int32) HexUnescape(String, Int32) HexUnescape(String, Int32) HexUnescape(String, Int32)

Konvertiert eine angegebene Hexadezimaldarstellung eines Zeichens in das Zeichen selbst. Converts a specified hexadecimal representation of a character to the character.

InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

Ruft ein Lebensdauerdienstobjekt zur Steuerung der Lebensdauerrichtlinie für diese Instanz ab. Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
IsBadFileSystemCharacter(Char) IsBadFileSystemCharacter(Char) IsBadFileSystemCharacter(Char) IsBadFileSystemCharacter(Char)

Ruft ab, ob ein Zeichen in einem Dateisystemnamen ungültig ist. Gets whether a character is invalid in a file system name.

IsBaseOf(Uri) IsBaseOf(Uri) IsBaseOf(Uri) IsBaseOf(Uri)

Bestimmt, ob die aktuelle Uri-Instanz eine Basis der angegebenen Uri-Instanz ist. Determines whether the current Uri instance is a base of the specified Uri instance.

IsExcludedCharacter(Char) IsExcludedCharacter(Char) IsExcludedCharacter(Char) IsExcludedCharacter(Char)

Ruft ab, ob das angegebene Zeichen mit Escapezeichen versehen werden soll. Gets whether the specified character should be escaped.

IsHexDigit(Char) IsHexDigit(Char) IsHexDigit(Char) IsHexDigit(Char)

Bestimmt, ob ein angegebenes Zeichen eine gültige Hexadezimalziffer ist. Determines whether a specified character is a valid hexadecimal digit.

IsHexEncoding(String, Int32) IsHexEncoding(String, Int32) IsHexEncoding(String, Int32) IsHexEncoding(String, Int32)

Bestimmt, ob ein Zeichen in einer Zeichenfolge hexadezimal codiert ist. Determines whether a character in a string is hexadecimal encoded.

IsReservedCharacter(Char) IsReservedCharacter(Char) IsReservedCharacter(Char) IsReservedCharacter(Char)

Ruft ab, ob das angegebene Zeichen ein reserviertes Zeichen ist. Gets whether the specified character is a reserved character.

IsWellFormedOriginalString() IsWellFormedOriginalString() IsWellFormedOriginalString() IsWellFormedOriginalString()

Gibt an, ob die zum Erstellen dieses Uri verwendete Zeichenfolge wohlgeformt war und keine weiteren Escapezeichen eingefügt werden müssen. Indicates whether the string used to construct this Uri was well-formed and is not required to be further escaped.

IsWellFormedUriString(String, UriKind) IsWellFormedUriString(String, UriKind) IsWellFormedUriString(String, UriKind) IsWellFormedUriString(String, UriKind)

Gibt an, ob eine Zeichenfolge wohlgeformt ist, indem versucht wird, einen URI aus der Zeichenfolge zu erstellen. Es wird sichergestellt, dass keine weiteren Escapezeichen in die Zeichenfolge eingefügt werden müssen. Indicates whether the string is well-formed by attempting to construct a URI with the string and ensures that the string does not require further escaping.

MakeRelative(Uri) MakeRelative(Uri) MakeRelative(Uri) MakeRelative(Uri)

Bestimmt den Unterschied zwischen zwei Uri-Instanzen. Determines the difference between two Uri instances.

MakeRelativeUri(Uri) MakeRelativeUri(Uri) MakeRelativeUri(Uri) MakeRelativeUri(Uri)

Bestimmt den Unterschied zwischen zwei Uri-Instanzen. Determines the difference between two Uri instances.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object. Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

Erstellt eine flache Kopie des aktuellen MarshalByRefObject-Objekts. Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
Parse() Parse() Parse() Parse()

Analysiert den URI der aktuellen Instanz, um sicherzustellen, dass alle für einen gültigen URI erforderlichen Teile enthalten sind. Parses the URI of the current instance to ensure it contains all the parts required for a valid URI.

ToString() ToString() ToString() ToString()

Ruft eine kanonische Zeichenfolgenentsprechung der angegebenen Uri-Instanz ab. Gets a canonical string representation for the specified Uri instance.

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

Erstellt mit der angegebenen Uri-Instanz und einer String einen neuen UriKind. Creates a new Uri using the specified String instance and a UriKind.

TryCreate(Uri, String, Uri) TryCreate(Uri, String, Uri) TryCreate(Uri, String, Uri) TryCreate(Uri, String, Uri)

Erstellt mit der angegebenen Basis und den relativen Uri-Instanzen einen neuen String. Creates a new Uri using the specified base and relative String instances.

TryCreate(Uri, Uri, Uri) TryCreate(Uri, Uri, Uri) TryCreate(Uri, Uri, Uri) TryCreate(Uri, Uri, Uri)

Erstellt mit der angegebenen Basis und den relativen Uri-Instanzen einen neuen Uri. Creates a new Uri using the specified base and relative Uri instances.

Unescape(String) Unescape(String) Unescape(String) Unescape(String)

Konvertiert die angegebene Zeichenfolge, indem alle Escapesequenzen durch die entsprechende Darstellung ohne Escapezeichen ersetzt werden. Converts the specified string by replacing any escape sequences with their unescaped representation.

UnescapeDataString(String) UnescapeDataString(String) UnescapeDataString(String) UnescapeDataString(String)

Konvertiert eine Zeichenfolge in eine Darstellung ohne Escapezeichen. Converts a string to its unescaped representation.

Operatoren

Equality(Uri, Uri) Equality(Uri, Uri) Equality(Uri, Uri) Equality(Uri, Uri)

Bestimmt, ob zwei Uri-Instanzen denselben Wert haben. Determines whether two Uri instances have the same value.

Inequality(Uri, Uri) Inequality(Uri, Uri) Inequality(Uri, Uri) Inequality(Uri, Uri)

Bestimmt, ob zwei Uri-Instanzen verschiedene Werte haben. Determines whether two Uri instances do not have the same value.

Explizite Schnittstellenimplementierungen

ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext) ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Gibt die Daten zurück, die zum Serialisieren der aktuellen Instanz benötigt werden. Returns the data needed to serialize the current instance.

Gilt für:

Siehe auch