UTF7Encoding Konstruktory

Definice

Obor názvů:

System.Text

Sestavení:

System.Text.Encoding.Extensions.dll

Inicializuje novou instanci UTF7Encoding třídy.

Přetížení

UTF7Encoding()	Zastaralé. Inicializuje novou instanci UTF7Encoding třídy.
UTF7Encoding(Boolean)	Zastaralé. Inicializuje novou instanci UTF7Encoding třídy. Parametr určuje, zda se mají povolit volitelné znaky.

UTF7Encoding()

Zdroj:

UTF7Encoding.cs

Upozornění

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

Inicializuje novou instanci UTF7Encoding třídy.

public:
 UTF7Encoding();

[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding ();

Public Sub New ()

Atributy

ObsoleteAttribute

Příklady

Následující příklad kódu ukazuje, jak vytvořit novou UTF7Encoding instanci a zobrazit název kódování.

using namespace System;
using namespace System::Text;
int main()
{
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   String^ encodingName = utf7->EncodingName;
   Console::WriteLine( "Encoding name: {0}", encodingName );
}

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

Poznámky

Tento konstruktor vytvoří instanci, která nepovoluje volitelné znaky. Volání konstruktoru UTF7Encoding je ekvivalentní volání konstruktoru UTF7Encoding.UTF7Encoding(Boolean) , který přebírá allowOptionals parametr a určuje false pro tento parametr.

Pokud instance umožňuje volitelné znaky, kódové body unicode jsou kódovány odpovídajícím volitelným znakem místo upraveného základního 64 znaku. Volitelné znaky jsou vykřičník ("!"), zpětné lomítko ("\"), svislá čára ("|"), dvojitá uvozovka ("""), znak čísla ("#"), znaménko dolaru ("$"), znak procenta ("%"), ampersand ("&"), hvězdička ("*"), středník (";"), vlevo úhlová závorka ("<"), pravá hranatá závorka (""),> levá složených závorek ("{"), pravá složených závorka ("}"), levá hranatá závorka ("["), pravá hranatá závorka ("]"), rovná se ("="), znak rovná se ("@"), přízvuk ("^"), podtržítko ("_") a přízvuk ("'").

Poznámka

UTF7Encoding neposkytuje detekci chyb. Z bezpečnostních důvodů se doporučuje, aby aplikace používaly UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolily detekci chyb.

UTF7Encoding(Boolean)

Zdroj:

UTF7Encoding.cs

Upozornění

The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.

Inicializuje novou instanci UTF7Encoding třídy. Parametr určuje, zda se mají povolit volitelné znaky.

public:
 UTF7Encoding(bool allowOptionals);

[System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public UTF7Encoding (bool allowOptionals);

[<System.Obsolete("The UTF-7 encoding is insecure and should not be used. Consider using UTF-8 instead.", DiagnosticId="SYSLIB0001", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Text.UTF7Encoding : bool -> System.Text.UTF7Encoding

Public Sub New (allowOptionals As Boolean)

Parametry

allowOptionals

Boolean

trueurčit, že volitelné znaky jsou povoleny; v opačném případě . false

Atributy

ObsoleteAttribute

Příklady

Následující příklad kódu ukazuje, jak vytvořit novou UTF7Encoding instanci, která umožňuje volitelné znaky.

using namespace System;
using namespace System::Text;
using namespace System::Collections;
void ShowArray( Array^ theArray )
{
   IEnumerator^ myEnum = theArray->GetEnumerator();
   while ( myEnum->MoveNext() )
   {
      Object^ o = safe_cast<Object^>(myEnum->Current);
      Console::Write( "[{0}]", o );
   }

   Console::WriteLine();
}

int main()
{
   
   // A few optional characters.
   String^ chars = "!@#$";
   
   // The default Encoding does not allow optional characters.
   // Alternate Byte values are used.
   UTF7Encoding^ utf7 = gcnew UTF7Encoding;
   array<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 = gcnew UTF7Encoding( true );
   array<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 ) );
}

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

Poznámky

Pokud instance umožňuje volitelné znaky, kódové body unicode jsou kódovány odpovídajícím volitelným znakem místo upraveného základního 64 znaku. Volitelné znaky jsou vykřičník ("!"), zpětné lomítko ("\"), svislá čára ("|"), dvojitá uvozovka ("""), znak čísla ("#"), znaménko dolaru ("$"), znak procenta ("%"), ampersand ("&"), hvězdička ("*"), středník (";"), vlevo úhlová závorka ("<"), pravá hranatá závorka (""),> levá složených závorek ("{"), pravá složených závorka ("}"), levá hranatá závorka ("["), pravá hranatá závorka ("]"), rovná se ("="), znak rovná se ("@"), přízvuk ("^"), podtržítko ("_") a přízvuk ("'").

Poznámka

UTF7Encoding neposkytuje detekci chyb. Z bezpečnostních důvodů se doporučuje, aby aplikace používaly UTF8Encoding, UnicodeEncodingnebo UTF32Encoding a povolily detekci chyb.