UTF7Encoding Constructors

public:
 UTF7Encoding();

public UTF7Encoding();

Public Sub New ()

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een nieuw UTF7Encoding exemplaar maakt en de naam van de codering weergeeft.

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        UTF7Encoding utf7 = new UTF7Encoding();
        String encodingName = utf7.EncodingName;
        Console.WriteLine("Encoding name: " + encodingName);
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        Dim utf7 As New UTF7Encoding()
        Dim encodingName As String = utf7.EncodingName
        Console.WriteLine("Encoding name: " & encodingName)
    End Sub
End Class

Opmerkingen

Met deze constructor maakt u een exemplaar dat geen optionele tekens toestaat. Het aanroepen van de UTF7Encoding constructor is gelijk aan het aanroepen van de UTF7Encoding.UTF7Encoding(Boolean) constructor die een allowOptionals parameter gebruikt en die voor die parameter opgeeft false .

Als een exemplaar optionele tekens toestaat, worden Unicode-codepunten gecodeerd met een bijbehorend optioneel teken in plaats van een gewijzigd base 64-teken. De optionele tekens zijn uitroeptekens ("!"), achterwaartse slash ("\"), verticale lijn ("|"), dubbele aanhalingsteken ("""), getalteken ("#"), dollarteken ("$"), procentteken ("%"), sterretje ("&"), sterretje ("*"), puntkomma (";"), linkerhoek haakje (""), rechte hoekhaak ("<>"), haakje links ("{"), rechte accolade ("}"), vierkante haak links ("["), rechte vierkante haak ("]"), gelijkteken ("="), bij teken ("@"), omtrekaccent ("^"), onderstrepingsteken ("_"), en accent grave ("'").

public:
 UTF7Encoding(bool allowOptionals);

public UTF7Encoding(bool allowOptionals);

new System.Text.UTF7Encoding : bool -> System.Text.UTF7Encoding

Public Sub New (allowOptionals As Boolean)

Parameters

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een nieuw UTF7Encoding exemplaar maakt dat optionele tekens toestaat.

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {

        // A few optional characters.
        string chars = "!@#$";

        // The default Encoding does not allow optional characters.
        // Alternate byte values are used.
        UTF7Encoding utf7 = new UTF7Encoding();
        Byte[] bytes1 = utf7.GetBytes(chars);
        
        Console.WriteLine("Default UTF7 Encoding:");
        ShowArray(bytes1);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7.GetChars(bytes1));

        // Now, allow optional characters.
        // Optional characters are encoded with their normal code points.
        UTF7Encoding utf7AllowOptionals = new UTF7Encoding(true);
        Byte[] bytes2 = utf7AllowOptionals.GetBytes(chars);
        
        Console.WriteLine("UTF7 Encoding with optional characters allowed:");
        ShowArray(bytes2);

        // Convert back to characters.
        Console.WriteLine("Characters:");
        ShowArray(utf7AllowOptionals.GetChars(bytes2));
    }

    public static void ShowArray(Array theArray) {
        foreach (Object o in theArray) {
            Console.Write("[{0}]", o);
        }
        Console.WriteLine();
    }
}

Imports System.Text

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        
        ' A few optional characters.
        Dim chars As String = "!@#$"
        
        ' The default Encoding does not allow optional characters.
        ' Alternate byte values are used.
        Dim utf7 As New UTF7Encoding()
        Dim bytes1 As Byte() = utf7.GetBytes(chars)
        
        Console.WriteLine("Default UTF7 Encoding:")
        ShowArray(bytes1)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7.GetChars(bytes1))
        
        ' Now, allow optional characters.
        ' Optional characters are encoded with their normal code points.
        Dim utf7AllowOptionals As New UTF7Encoding(True)
        Dim bytes2 As Byte() = utf7AllowOptionals.GetBytes(chars)
        
        Console.WriteLine("UTF7 Encoding with optional characters allowed:")
        ShowArray(bytes2)
        
        ' Convert back to characters.
        Console.WriteLine("Characters:")
        ShowArray(utf7AllowOptionals.GetChars(bytes2))
    End Sub
    
    
    Public Shared Sub ShowArray(theArray As Array)
        Dim o As Object
        For Each o In  theArray
            Console.Write("[{0}]", o)
        Next o
        Console.WriteLine()
    End Sub
End Class

Opmerkingen

Als een exemplaar optionele tekens toestaat, worden Unicode-codepunten gecodeerd met een bijbehorend optioneel teken in plaats van een gewijzigd base 64-teken. De optionele tekens zijn uitroeptekens ("!"), achterwaartse slash ("\"), verticale lijn ("|"), dubbele aanhalingsteken ("""), getalteken ("#"), dollarteken ("$"), procentteken ("%"), sterretje ("&"), sterretje ("*"), puntkomma (";"), linkerhoek haakje (""), rechte hoekhaak ("<>"), haakje links ("{"), rechte accolade ("}"), vierkante haak links ("["), rechte vierkante haak ("]"), gelijkteken ("="), bij teken ("@"), omtrekaccent ("^"), onderstrepingsteken ("_"), en accent grave ("'").