Article
11/18/2011

Encoding.WebName Property

Microsoft Silverlight will reach end of support after October 2021. Learn more.

When overridden in a derived class, gets the name registered with the Internet Assigned Numbers Authority (IANA) for the current encoding.

Namespace: System.Text
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overridable ReadOnly Property WebName As String

public virtual string WebName { get; }

Property Value

Type: System.String
The IANA name for the current Encoding.

Remarks

The WebName property returns an IANA-registered name for the encoding. It returns the strings shown in the following table for the encodings supported by Silverlight.

Encoding	WebName property value
UTF8	utf-8
Unicode	utf-16
BigEndianUnicode	utf-16BE

Examples

The following example displays the WebName property for each of the encodings supported by the .NET Framework for Silverlight.

Imports System.Text

Public Module Example
   Public Sub Demo(outputBlock As System.Windows.Controls.TextBlock)
      Dim encodingName As String

      ' Get UTF8 encoding object.
      Dim enc8 As Encoding = Encoding.Utf8
      encodingName = enc8.WebName
      outputBlock.Text += String.Format("{0}: {1}", enc8.ToString(), _
                                        enc8.WebName) + vbCrLF
      outputBlock.Text += CStr(enc8.Equals(Encoding.GetEncoding(encodingName))) + vbCrLf

      ' Get UTF16 encoding object.
      Dim enc16 As Encoding = Encoding.Unicode
      encodingName = enc16.WebName
      outputBlock.Text += String.Format("{0}: {1}", enc16.ToString(), _
                                        enc16.WebName) + vbCrLF
      outputBlock.Text += CStr(enc16.Equals(Encoding.GetEncoding(encodingName))) + vbCrLf

      ' Get UTF16 big endian encoding object.
      enc16 = Encoding.BigEndianUnicode
      encodingName = enc16.WebName
      outputBlock.Text += String.Format("{0}: {1}", enc16.ToString(), _
                                        enc16.WebName) + vbCrLF
      outputBlock.Text += CStr(enc16.Equals(Encoding.GetEncoding(encodingName))) + vbCrLf
   End Sub
End Module
' The example displays the following output:
'     System.Text.UTF8Encoding: utf-8
'     True
'     System.Text.UnicodeEncoding: utf-16
'     True
'     system.Text.UnicodeEncoding: utf-16BE
'     True

using System;
using System.Text;

public class Example
{
   public static void Demo(System.Windows.Controls.TextBlock outputBlock)
   {
      string encodingName;

      // Get UTF8 encoding object.
      Encoding enc8 = Encoding.UTF8;
      encodingName = enc8.WebName;
      outputBlock.Text += String.Format("{0}: {1}\n", enc8.ToString(), enc8.WebName);
      outputBlock.Text += enc8.Equals(Encoding.GetEncoding(encodingName)) + "\n";

      // Get UTF16 encoding object.
      Encoding enc16 = Encoding.Unicode;
      encodingName = enc16.WebName;
      outputBlock.Text += String.Format("{0}: {1}\n", enc16.ToString(), enc16.WebName);
      outputBlock.Text += enc16.Equals(Encoding.GetEncoding(encodingName)) + "\n";

      // Get UTF16 big endian encoding object.
      enc16 = Encoding.BigEndianUnicode;
      encodingName = enc16.WebName;
      outputBlock.Text += String.Format("{0}: {1}\n", enc16.ToString(), enc16.WebName);
      outputBlock.Text += enc16.Equals(Encoding.GetEncoding(encodingName)) + "\n";
   }
}
// The example displays the following output:
//     System.Text.UTF8Encoding: utf-8
//     True
//     System.Text.UnicodeEncoding: utf-16
//     True
//     system.Text.UnicodeEncoding: utf-16BE
//     True

Version Information

Silverlight

Supported in: 5, 4, 3

Silverlight for Windows Phone

Supported in: Windows Phone OS 7.1, Windows Phone OS 7.0

XNA Framework

Supported in: Xbox 360, Windows Phone OS 7.0

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.