Прочитать на английском

Поделиться через


Uri.OriginalString Свойство

Определение

Возвращает исходную строку универсального кода ресурса, переданную в конструктор Uri.

C#
public string OriginalString { get; }

Значение свойства

Точный URI, указанный при создании этого экземпляра; в противном случае — Empty.

Примеры

В следующем примере создается новый Uri экземпляр из строки. Она демонстрирует разницу между значением, возвращаемым из OriginalString, который возвращает строку, переданную конструктору, и из вызова ToString, который возвращает каноническую форму строки.

C#
// Create a new Uri from a string address.
Uri uriAddress = new Uri("HTTP://www.ConToso.com:80//thick%20and%20thin.htm");

// Write the new Uri to the console and note the difference in the two values.
// ToString() gives the canonical version. OriginalString gives the original
// string that was passed to the constructor.

// The following outputs "http://www.contoso.com//thick and thin.htm".
Console.WriteLine(uriAddress.ToString());

// The following outputs "HTTP://www.ConToso.com:80//thick%20and%20thin.htm".
Console.WriteLine(uriAddress.OriginalString);

Комментарии

Если URI, указанный в конструкторе, содержит начальные или конечные пробелы, эти пробелы сохраняются.

Значение, возвращаемое этим свойством, отличается от ToString и AbsoluteUri. ToString возвращает канонически неэкранированную форму URI. AbsoluteUri возвращает канонически экранированную форму универсального кода ресурса (URI).

Если включена поддержка международного идентификатора ресурса (IRI) и международного доменного имени (IDN), возвращает исходную ненормализованную строку с именем узла Punycode, OriginalString если она использовалась для инициализации экземпляра Uri . Имена Punicode содержат только символы ASCII и всегда начинаются с префикса "xn--".

Дополнительные сведения о поддержке IRI см. в разделе Примечания Uri для класса .

Uri При сериализации OriginalString объекта объект не сохраняется. При сериализации в процессе сериализации используется полностью экранированное и каноническое AbsoluteUri свойство. Для объекта Uri , содержащего IPv6-адрес, IPv6-адрес и идентификатор область включаются в сериализованный Uri объект.

Применяется к

Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0