UTF7Encoding Klas

Definitie

Naamruimte:: System.Text

Assembly's:: mscorlib.dll, System.Text.Encoding.Extensions.dll

Assembly:: mscorlib.dll

Assembly:: System.Text.Encoding.Extensions.dll

Assembly:: netstandard.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Vertegenwoordigt een UTF-7-codering van Unicode-tekens.

public ref class UTF7Encoding : System::Text::Encoding

public class UTF7Encoding : System.Text.Encoding

[System.Serializable]
public class UTF7Encoding : System.Text.Encoding

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class UTF7Encoding : System.Text.Encoding

type UTF7Encoding = class
    inherit Encoding

[<System.Serializable>]
type UTF7Encoding = class
    inherit Encoding

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UTF7Encoding = class
    inherit Encoding

Public Class UTF7Encoding
Inherits Encoding

Overname: Object

Encoding
UTF7Encoding

Kenmerken: SerializableAttribute ComVisibleAttribute

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u een UTF7Encoding tekenreeks met Unicode-tekens codeert en opslaat in een bytematrix. Wanneer de bytematrix wordt gedecodeerd naar een tekenreeks, gaan er geen gegevens verloren.

using System;
using System.Text;

class UTF7EncodingExample {
    public static void Main() {
        // Create a UTF-7 encoding.
        UTF7Encoding utf7 = new UTF7Encoding();
        
        // A Unicode string with two characters outside a 7-bit code range.
        String unicodeString =
            "This Unicode string contains two characters " +
            "with codes outside a 7-bit code range, " +
            "Pi (\u03a0) and Sigma (\u03a3).";
        Console.WriteLine("Original string:");
        Console.WriteLine(unicodeString);

        // Encode the string.
        Byte[] encodedBytes = utf7.GetBytes(unicodeString);
        Console.WriteLine();
        Console.WriteLine("Encoded bytes:");
        foreach (Byte b in encodedBytes) {
            Console.Write("[{0}]", b);
        }
        Console.WriteLine();
        
        // Decode bytes back to string.
        // Notice Pi and Sigma characters are still present.
        String decodedString = utf7.GetString(encodedBytes);
        Console.WriteLine();
        Console.WriteLine("Decoded bytes:");
        Console.WriteLine(decodedString);
    }
}

Imports System.Text
Imports Microsoft.VisualBasic.Strings

Class UTF7EncodingExample
    
    Public Shared Sub Main()
        ' Create a UTF-7 encoding.
        Dim utf7 As New UTF7Encoding()
        
        ' A Unicode string with two characters outside a 7-bit code range.
        Dim unicodeString As String = _
            "This Unicode string contains two characters " & _
            "with codes outside a 7-bit code range, " & _
            "Pi (" & ChrW(928) & ") and Sigma (" & ChrW(931) & ")."
        Console.WriteLine("Original string:")
        Console.WriteLine(unicodeString)
        
        ' Encode the string.
        Dim encodedBytes As Byte() = utf7.GetBytes(unicodeString)
        Console.WriteLine()
        Console.WriteLine("Encoded bytes:")
        Dim b As Byte
        For Each b In  encodedBytes
            Console.Write("[{0}]", b)
        Next b
        Console.WriteLine()
        
        ' Decode bytes back to string.
        ' Notice Pi and Sigma characters are still present.
        Dim decodedString As String = utf7.GetString(encodedBytes)
        Console.WriteLine()
        Console.WriteLine("Decoded bytes:")
        Console.WriteLine(decodedString)
    End Sub
End Class

Opmerkingen

Encoding is het proces van het transformeren van een set Unicode-tekens in een reeks bytes. Decodering is het proces van het transformeren van een reeks gecodeerde bytes in een set Unicode-tekens.

De UTF-7-codering vertegenwoordigt Unicode-tekens als reeksen van 7-bits ASCII-tekens. Deze codering ondersteunt bepaalde protocollen waarvoor het vereist is, meestal e-mail of nieuwsgroepprotocollen. Omdat UTF-7 niet bijzonder veilig of robuust is en de meeste moderne systemen 8-bits coderingen toestaan, moet UTF-8 normaal gesproken de voorkeur geven aan UTF-7.

Note

UTF7Encoding biedt geen foutdetectie. Om veiligheidsredenen moet de toepassing foutdetectie gebruiken UTF8Encoding, UnicodeEncodingof UTF32Encoding inschakelen.

Zie Character Encoding in het .NET Framework voor meer informatie over de UDF's en andere coderingen die worden ondersteund door System.Text.

De GetByteCount methode bepaalt hoeveel bytes resulteren in het coderen van een set Unicode-tekens en de GetBytes methode voert de daadwerkelijke codering uit.

Op dezelfde manier bepaalt de GetCharCount methode hoeveel tekens resulteren in het decoderen van een reeks bytes, en de GetChars en GetString methoden voeren de daadwerkelijke decodering uit.

UTF7Encoding komt overeen met de Windows codepagina 65000.

Note

De status van een UTF-7 gecodeerd object blijft niet behouden als het object wordt geserialiseerd en gedeserialiseerd met verschillende .NET Framework-versies.

Constructors

Name	Description
UTF7Encoding()	Initialiseert een nieuw exemplaar van de UTF7Encoding klasse.
UTF7Encoding(Boolean)	Initialiseert een nieuw exemplaar van de UTF7Encoding klasse. Een parameter geeft aan of optionele tekens moeten worden toegestaan.

Eigenschappen

Name	Description
BodyName	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een naam voor de huidige codering die kan worden gebruikt met hoofdtags van de e-mailagent. (Overgenomen van Encoding)
CodePage	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de codepagina-id van de huidige Encodingop. (Overgenomen van Encoding)
DecoderFallback	Hiermee wordt het DecoderFallback object voor het huidige Encoding object opgehaald of ingesteld. (Overgenomen van Encoding)
EncoderFallback	Hiermee wordt het EncoderFallback object voor het huidige Encoding object opgehaald of ingesteld. (Overgenomen van Encoding)
EncodingName	Wanneer deze wordt overschreven in een afgeleide klasse, wordt de leesbare beschrijving van de huidige codering opgehaald. (Overgenomen van Encoding)
HeaderName	Wanneer deze worden overschreven in een afgeleide klasse, krijgt u een naam voor de huidige codering die kan worden gebruikt met headertags van de e-mailagent. (Overgenomen van Encoding)
IsBrowserDisplay	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door browserclients om inhoud weer te geven. (Overgenomen van Encoding)
IsBrowserSave	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door browserclients voor het opslaan van inhoud. (Overgenomen van Encoding)
IsMailNewsDisplay	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door mail- en nieuwsclients om inhoud weer te geven. (Overgenomen van Encoding)
IsMailNewsSave	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering kan worden gebruikt door e-mail- en nieuwsclients om inhoud op te slaan. (Overgenomen van Encoding)
IsReadOnly	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of de huidige codering het kenmerk Alleen-lezen heeft. (Overgenomen van Encoding)
IsSingleByte	Wanneer deze wordt overschreven in een afgeleide klasse, wordt een waarde opgehaald die aangeeft of de huidige codering gebruikmaakt van codepunten met één byte. (Overgenomen van Encoding)
Preamble	Wanneer deze wordt overschreven in een afgeleide klasse, retourneert u een bereik met de reeks bytes die de gebruikte codering aangeeft. (Overgenomen van Encoding)
WebName	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de naam op die is geregistreerd bij de Internet Assigned Numbers Authority (IANA) voor de huidige codering. (Overgenomen van Encoding)
WindowsCodePage	Wanneer deze wordt overschreven in een afgeleide klasse, haalt u de Windows codepagina van het besturingssysteem op die het meest overeenkomt met de huidige codering. (Overgenomen van Encoding)

Methoden

Name	Description
Clone()	Wanneer deze wordt overschreven in een afgeleide klasse, maakt u een ondiepe kopie van het huidige Encoding object. (Overgenomen van Encoding)
Equals(Object)	Hiermee wordt een waarde opgehaald die aangeeft of het opgegeven object gelijk is aan het huidige UTF7Encoding object.
Equals(Object)	Bepaalt of de opgegeven Object waarde gelijk is aan het huidige exemplaar. (Overgenomen van Encoding)
GetByteCount(Char[], Int32, Int32)	Berekent het aantal bytes dat wordt geproduceerd door een set tekens van de opgegeven tekenmatrix te coderen.
GetByteCount(Char[])	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door alle tekens in de opgegeven tekenmatrix te coderen. (Overgenomen van Encoding)
GetByteCount(Char*, Int32)	Berekent het aantal bytes dat wordt geproduceerd door een set tekens te coderen die beginnen bij de opgegeven tekenwijzer.
GetByteCount(ReadOnlySpan<Char>)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door de tekens in het opgegeven tekenbereik te coderen. (Overgenomen van Encoding)
GetByteCount(String, Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door een set tekens van de opgegeven tekenreeks te coderen. (Overgenomen van Encoding)
GetByteCount(String)	Berekent het aantal bytes dat wordt geproduceerd door de tekens in het opgegeven String object te coderen.
GetByteCount(String)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal bytes dat wordt geproduceerd door de tekens in de opgegeven tekenreeks te coderen. (Overgenomen van Encoding)
GetBytes(Char[], Int32, Int32, Byte[], Int32)	Codeert een set tekens van de opgegeven tekenmatrix in de opgegeven bytematrix.
GetBytes(Char[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u een set tekens van de opgegeven tekenmatrix in een reeks bytes. (Overgenomen van Encoding)
GetBytes(Char[])	Wanneer deze worden overschreven in een afgeleide klasse, codeert u alle tekens in de opgegeven tekenmatrix in een reeks bytes. (Overgenomen van Encoding)
GetBytes(Char, Int32, Byte, Int32)	Codeert een reeks tekens die beginnen bij de opgegeven tekenwijzer in een reeks bytes die zijn opgeslagen vanaf de opgegeven byte-aanwijzer.
GetBytes(ReadOnlySpan<Char>, Span<Byte>)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u in een reeks bytes die een reeks tekens bevat van de opgegeven alleen-lezen periode. (Overgenomen van Encoding)
GetBytes(String, Int32, Int32, Byte[], Int32)	Codeert een set tekens van de opgegeven in de opgegeven String bytematrix.
GetBytes(String, Int32, Int32, Byte[], Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u een set tekens van de opgegeven tekenreeks in de opgegeven bytematrix. (Overgenomen van Encoding)
GetBytes(String, Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, codeert u in een matrix van bytes het aantal tekens dat is opgegeven in `count` de opgegeven tekenreeks, beginnend bij de opgegeven `index`tekenreeks. (Overgenomen van Encoding)
GetBytes(String)	Wanneer deze worden overschreven in een afgeleide klasse, codeert u alle tekens in de opgegeven tekenreeks in een reeks bytes. (Overgenomen van Encoding)
GetCharCount(Byte[], Int32, Int32)	Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes van de opgegeven bytematrix.
GetCharCount(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door alle bytes in de opgegeven bytematrix te decoderen. (Overgenomen van Encoding)
GetCharCount(Byte*, Int32)	Berekent het aantal tekens dat wordt geproduceerd door het decoderen van een reeks bytes die beginnen bij de opgegeven byteaanwijzer.
GetCharCount(ReadOnlySpan<Byte>)	Wanneer deze wordt overschreven in een afgeleide klasse, berekent u het aantal tekens dat wordt geproduceerd door de opgegeven bytespanne met het kenmerk Alleen-lezen te decoderen. (Overgenomen van Encoding)
GetChars(Byte[], Int32, Int32, Char[], Int32)	Decodeert een reeks bytes van de opgegeven bytematrix in de opgegeven tekenmatrix.
GetChars(Byte[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een reeks bytes van de opgegeven bytematrix in een reeks tekens. (Overgenomen van Encoding)
GetChars(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven bytematrix in een set tekens. (Overgenomen van Encoding)
GetChars(Byte, Int32, Char, Int32)	Decodeert een reeks bytes die beginnen bij de opgegeven byteaanwijzer in een set tekens die zijn opgeslagen vanaf de opgegeven tekenaanwijzer.
GetChars(ReadOnlySpan<Byte>, Span<Char>)	Wanneer deze wordt overschreven in een afgeleide klasse, decodeert u alle bytes in de opgegeven bytespanne met het kenmerk Alleen-lezen in een tekenbereik. (Overgenomen van Encoding)
GetDecoder()	Hiermee haalt u een decoder op waarmee een UTF-7 gecodeerde reeks bytes wordt geconverteerd naar een reeks Unicode-tekens.
GetEncoder()	Hiermee verkrijgt u een coderingsprogramma waarmee een reeks Unicode-tekens wordt geconverteerd naar een UTF-7 gecodeerde reeks bytes.
GetHashCode()	Retourneert de hashcode voor het huidige UTF7Encoding object.
GetHashCode()	Retourneert de hash-code voor het huidige exemplaar. (Overgenomen van Encoding)
GetMaxByteCount(Int32)	Berekent het maximum aantal bytes dat wordt geproduceerd door het opgegeven aantal tekens te coderen.
GetMaxCharCount(Int32)	Berekent het maximum aantal tekens dat wordt geproduceerd door het opgegeven aantal bytes te decoderen.
GetPreamble()	Wanneer deze wordt overschreven in een afgeleide klasse, retourneert u een reeks bytes die de gebruikte codering aangeeft. (Overgenomen van Encoding)
GetString(Byte[], Int32, Int32)	Decodeert een bereik van bytes van een bytematrix in een tekenreeks.
GetString(Byte[], Int32, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een reeks bytes van de opgegeven bytematrix in een tekenreeks. (Overgenomen van Encoding)
GetString(Byte[])	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven bytematrix in een tekenreeks. (Overgenomen van Encoding)
GetString(Byte*, Int32)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u een opgegeven aantal bytes dat begint bij een opgegeven adres in een tekenreeks. (Overgenomen van Encoding)
GetString(ReadOnlySpan<Byte>)	Wanneer deze wordt overschreven in een afgeleide klasse, ontsleutelt u alle bytes in de opgegeven byte span in een tekenreeks. (Overgenomen van Encoding)
GetType()	Hiermee haalt u de Type huidige instantie op. (Overgenomen van Object)
IsAlwaysNormalized()	Hiermee wordt een waarde opgehaald die aangeeft of de huidige codering altijd is genormaliseerd, met behulp van de standaardnormalisatievorm. (Overgenomen van Encoding)
IsAlwaysNormalized(NormalizationForm)	Wanneer deze wordt overschreven in een afgeleide klasse, krijgt u een waarde die aangeeft of de huidige codering altijd is genormaliseerd, met behulp van de opgegeven normalisatievorm. (Overgenomen van Encoding)
MemberwiseClone()	Hiermee maakt u een ondiepe kopie van de huidige Object. (Overgenomen van Object)
ToString()	Retourneert een tekenreeks die het huidige object vertegenwoordigt. (Overgenomen van Object)

Van toepassing op

Zie ook

Feedback

Is deze pagina nuttig?