Platform::String-KlassePlatform::String Class

Stellt eine sequenzielle Auflistung von Unicode-Zeichen dar, die zum Darstellen von Text verwendet werden.Represents a sequential collection of Unicode characters that is used to represent text. Weitere Informationen und Beispiele finden Sie unter Zeichenfolgen.For more information and examples, see Strings.

SyntaxSyntax


public ref class String sealed : Object,  
    IDisposable,  
    IEquatable,  
    IPrintable  

IteratorsIterators

Zwei Iteratorfunktionen, die nicht Member der Zeichenfolgenklasse sind, können mit der Vorlagenfunktion std::for_each verwendet werden, um die Zeichen in einem Zeichenfolgenobjekt aufzulisten.Two iterator functions, which are not members of the String class, can be used with the std::for_each template function to enumerate the characters in a String object.

MemberMember BeschreibungDescription
const char16* begin(String^ s) Gibt einen Zeiger auf den Anfang des angegebenen Zeichenfolgenobjekts zurück.Returns a pointer to the beginning of the specified String object.
const char16* end(String^ s) Gibt einen Zeiger nach dem Ende des angegebenen Zeichenfolgenobjekts zurück.Returns a pointer past the end of the specified String object.

MemberMembers

Die Zeichenfolgenklasse erbt vom Objekt und den Schnittstellen IDisposable, IEquatable und IPrintable.The String class inherits from Object, and the IDisposable, IEquatable, and IPrintable interfaces.

Die Zeichenfolgenklasse verfügt auch über die folgenden Typen von Membern.The String class also has the following types of members.

KonstruktorenConstructors

MemberMember BeschreibungDescription
String::StringString::String Initialisiert eine neue Instanz der Zeichenfolgenklasse.Initializes a new instance of the String class.

MethodenMethods

Die Zeichenfolgenklasse erbt die Methoden Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose() und ToString() von Platform::Object Class.The String class inherits the Equals(), Finalize(), GetHashCode(), GetType(), MemberwiseClose(), and ToString() methods from the Platform::Object Class. Die Zeichenfolge hat auch die folgenden Methoden.String also has the following methods.

MethodeMethod BeschreibungDescription
String::BeginString::Begin Gibt einen Zeiger auf den Anfang der aktuellen Zeichenfolge zurück.Returns a pointer to the beginning of the current string.
String::CompareOrdinalString::CompareOrdinal Vergleicht zwei String -Objekte durch Auswertung der numerischen Werte der entsprechenden Zeichen in den beiden Zeichenfolgenwerten, die durch die Objekte dargestellt werden.Compares two String objects by evaluating the numeric values of the corresponding characters in the two string values represented by the objects.
String::ConcatString::Concat Verkettet die Werte von zwei Zeichenfolgenobjekten.Concatenates the values of two String objects.
String::DataString::Data Gibt einen Zeiger auf den Anfang der aktuellen Zeichenfolge zurück.Returns a pointer to the beginning of the current string.
String:: DisposeString::Dispose Gibt Ressourcen frei.Frees or releases resources.
String::EndString::End Gibt einen Zeiger nach dem Ende der aktuellen Zeichenfolge zurück.Returns a pointer past the end of the current string.
String::EqualsString::Equals Gibt an, ob das angegebene Objekt gleich dem aktuellen Objekt ist.Indicates whether the specified object is equal to the current object.
String::GetHashCodeString::GetHashCode Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.
String::IsEmptyString::IsEmpty Gibt an, ob das aktuelle String-Objekt leer ist.Indicates whether the current String object is empty.
String::IsFastPassString::IsFastPass Gibt an, ob das aktuelle String-Objekt an einem Fast-Pass -Vorgang teilnimmt.Indicates whether the current String object is is participating in a fast pass operation. Bei einem Fast-Pass-Vorgang wird die Verweiszählung angehalten.In a fast pass operation, reference counting is suspended.
String::LengthString::Length Ruft die Länge des aktuellen Zeichenfolgenobjekts ab.Retrieves the length of the current String object.
String::ToStringString::ToString Gibt ein neues Zeichenfolgenobjekt zurück, dessen Wert mit der aktuellen Zeichenfolge identisch ist.Returns a String object whose value is the same as the current string.

OperatorenOperators

Die Zeichenfolgenklasse hat die folgenden Operatoren.The String class has the following operators.

MemberMember BeschreibungDescription
String:: Operator ==-OperatorString::operator== Operator Gibt an, ob zwei angegebene Zeichenfolgenobjekte denselben Wert haben.Indicates whether two specifed String objects have the same value.
operator+-Operatoroperator+ Operator Verkettet zwei Zeichenfolgeobjekte in ein neues Zeichenfolgeobjekt.Concatenates two String objects into a new String object.
String:: Operator >-OperatorString::operator> Operator Gibt an, ob der Wert eines Zeichenfolgenobjekts größer als der Wert eines zweiten Zeichenfolgenobjekts ist.Indicates whether the value of one String object is greater than the value of a second String object.
String:: Operator > =-OperatorString::operator>= Operator Gibt an, ob der Wert eines String-Objekts größer oder gleich dem Wert eines zweiten String-Objekts ist.Indicates whether the value of one String object is greater than or equal to the value of a second String object.
String:: Operator! =-OperatorString::operator!= Operator Gibt an, ob zwei angegebene Zeichenfolgenobjekte unterschiedliche Werte haben.Indicates whether two specifed String objects have different values.
String:: Operator <-OperatorString::operator< Operator Gibt an, ob der Wert eines Zeichenfolgenobjekts kleiner als der Wert eines zweiten Zeichenfolgenobjekts ist.Indicates whether the value of one String object is less than the value of a second String object.

AnforderungenRequirements

Unterstützter Client: Windows 8Minimum supported client: Windows 8

Unterstützter Server: Windows Server 2012Minimum supported server: Windows Server 2012

Namespace: PlatformNamespace: Platform

Header vccorlib.h (standardmäßig eingeschlossen)Header vccorlib.h (included by default)

String:: Begin-MethodeString::Begin Method

Gibt einen Zeiger auf den Anfang der aktuellen Zeichenfolge zurück.Returns a pointer to the beginning of the current string.

SyntaxSyntax


char16* Begin()  

RückgabewertReturn Value

Ein Zeiger auf den Anfang der aktuellen Zeichenfolge.A pointer to the beginning of the current string.

String:: CompareOrdinal-MethodeString::CompareOrdinal Method

Vergleicht zwei String -Objekte durch Auswertung der numerischen Werte der entsprechenden Zeichen in den beiden Zeichenfolgenwerten, die durch die Objekte dargestellt werden.Compares two String objects by evaluating the numeric values of the corresponding characters in the two string values represented by the objects.

SyntaxSyntax


int CompareOrdinal(  
           String^ str1,   
           String^ str2)  

ParameterParameters

str1
Das erste String-Objekt.The first String object.

str2
Das zweite String-Objekt.The second String object.

RückgabewertReturn Value

Eine ganze Zahl, die die lexikalische Beziehung zwischen den beiden Vergleichswerten angibt.An integer that indicates the lexical relationship between the two comparands. In der folgenden Tabelle sind die möglichen Rückgabewerte aufgelistet:The following table lists the possible return values.

WertValue BedingungCondition
-1-1 str1 ist kleiner als str2.str1 is less than str2.
00 str1 ist gleich str2.str1 is equals str2.
11 str1 ist größer als str2.str1 is greater than str2.

String:: concat-MethodeString::Concat Method

Verkettet die Werte von zwei Zeichenfolgenobjekten.Concatenates the values of two String objects.

SyntaxSyntax

String^ Concat( String^ str1, String^ str2)  

ParameterParameters

str1
Das erste Zeichenfolgenobjekt oder null.The first String object, or null.

str2
Das zweite Zeichenfolgenobjekt oder null.The second String object, or null.

RückgabewertReturn Value

Ein neues Zeichenfolgen^-Objekt, dessen Wert die Verkettung der Werte von str1 und str2 ist.A new String^ object whose value is the concatenation of the values of str1 and str2.

Wenn str1 ist null und str2 nicht, str1 wird zurückgegeben.If str1 is null and str2 is not, str1 is returned. Wenn str2 ist null und str1 nicht, str2 wird zurückgegeben.If str2 is null and str1 is not, str2 is returned. Wenn str1 und str2 beide null sind, wird die leere Zeichenfolge (L "") zurückgegeben.If str1 and str2 are both null, the empty string (L"") is returned.

String:: Data-MethodeString::Data Method

Gibt einen Zeiger zum Anfang des Datenpuffers des Objekts als ein Array im C-Format mit char16-Elementen (wchar_t) zurück.Returns a pointer to the beginning of the object's data buffer as a C-style array of char16 (wchar_t) elements.

SyntaxSyntax

const char16* Data()  

RückgabewertReturn Value

Ein Zeiger auf den Anfang einer const char16 Array von Unicode-Zeichen (char16 ist eine Typedef für wchar_t).A pointer to the beginning of a const char16 array of Unicode characters (char16 is a typedef for wchar_t).

HinweiseRemarks

Verwenden Sie diese Methode zum Konvertieren von Platform::String^ zu wchar_t*.Use this method to convert from Platform::String^ to wchar_t*. Wenn das String-Objekt den Gültigkeitsbereich verlässt, ist die Gültigkeit des Datenzeigers nicht mehr sichergestellt.When the String object goes out of scope, the Data pointer is no longer guaranteed to be valid. Zum Speichern der Daten nach Ablauf der Lebensdauer des ursprünglichen String -Objekts Wcscpy_s zum Kopieren des Arrays in den Arbeitsspeicher, die Sie selbst zugeordnet haben.To store the data beyond the lifetime of the original String object, use wcscpy_s to copy the array into memory that you have allocated yourself.

String:: Dispose-MethodeString::Dispose Method

Gibt Ressourcen frei.Frees or releases resources.

SyntaxSyntax


virtual override void Dispose()  

String:: End-MethodeString::End Method

Gibt einen Zeiger nach dem Ende der aktuellen Zeichenfolge zurück.Returns a pointer past the end of the current string.

SyntaxSyntax


char16* End()  

RückgabewertReturn Value

Ein Zeiger zur Übergabe des Endes der aktuellen Zeichenfolge.A pointer to past the end of the current string.

HinweiseRemarks

End() gibt Begin() + Länge zurück.End() returns Begin() + Length.

String:: Equals-MethodeString::Equals Method

Gibt an, ob die angegebene Zeichenfolge über den gleichen Wert wie das aktuelle Objekt verfügt.Indicates whether the specified String has the same value as the current object.

SyntaxSyntax


bool String::Equals(Object^ str);  

bool String::Equals(String^ str);  

ParameterParameters

str
Das zu vergleichende Objekt.The object to compare.

RückgabewertReturn Value

true, wenn str gleich dem aktuellen Objekt ist, andernfalls false.true if str is equal to the current object; otherwise, false.

HinweiseRemarks

Diese Methode entspricht der String:: CompareOrdinal.This method is equivalent to the String::CompareOrdinal. In der ersten Überladung wird erwartet, dass der Parameter str zu einem String^-Objekt umgewandelt werden kann.In the first overload, it is expected the str parameter can be cast to a String^ object.

String:: GetHashCode-MethodeString::GetHashCode Method

Gibt den Hashcode für diese Instanz zurück.Returns the hash code for this instance.

SyntaxSyntax


virtual override int GetHashCode()  

RückgabewertReturn Value

Der Hashcode für diese Instanz.The hash code for this instance.

String:: isEmpty-MethodeString::IsEmpty Method

Gibt an, ob das aktuelle String-Objekt leer ist.Indicates whether the current String object is empty.

SyntaxSyntax

bool IsEmpty()  

RückgabewertReturn Value

true, wenn das aktuelle String-Objekt null oder die leere Zeichenfolge (L "") ist; andernfalls false.true if the current String object is null or the empty string (L""); otherwise, false.

String:: isfastpass-MethodeString::IsFastPass Method

Gibt an, ob das aktuelle String-Objekt an einem Fast-Pass -Vorgang teilnimmt.Indicates whether the current String object is is participating in a fast pass operation. Bei einem Fast-Pass-Vorgang wird die Verweiszählung angehalten.In a fast pass operation, reference counting is suspended.

SyntaxSyntax

bool IsFastPass();  

RückgabewertReturn Value

true, wenn das aktuelle String-Objekt FAST-PASS ist; andernfalls false.true if the current String object is fast-past; otherwise, false.

HinweiseRemarks

Beim Aufruf einer Funktion, bei der ein Objekt mit Verweiszählung ein Parameter ist und die aufgerufene Funktion nur dieses Objekt liest, kann der Compiler die Verweiszählung sicher anhalten und die Aufrufleistung verbessern.In a call to a function where a reference-counted object is a parameter, and the called function only reads that object, the compiler can safely suspend reference counting and improve calling performance. Es gibt nichts nützliches, das Ihr Code mit dieser Eigenschaft ausführen kann.There is nothing useful that your code can do with this property. Das System behandelt alle Details.The system handles all the details.

String:: Length-MethodeString::Length Method

Ruft die Anzahl von Zeichen im aktuellen Zeichenfolgenobjekt ab.Retrieves the number of characters in the current String object.

SyntaxSyntax

unsigned int Length()  

RückgabewertReturn Value

Die Anzahl von Zeichen im aktuellen Zeichenfolgenobjekt.The number of characters in the current String object.

HinweiseRemarks

Die Länge einer Zeichenfolge ohne Zeichen ist null.The length of a String with no characters is zero. Die Länge der folgenden Zeichenfolge ist 5:The length of the following string is 5:

String^ str = "Hello";  
int len = str->Length(); //len = 5  

Das zurückgegebene Array von Zeichen der String:: Data verfügt über ein zusätzliches Zeichen, das abschließende NULL oder '\0' ist.The character array returned by the String::Data has one additional character, which is the terminating NULL or '\0'. Dieses Zeichen ist ebenfalls zwei Bytes lang.This character is also two bytes long.

String:: Operator +-OperatorString::operator+ Operator

Verkettet zwei Zeichenfolge Objekte in eine neue Zeichenfolge Objekt.Concatenates two String objects into a new String object.

SyntaxSyntax


bool String::operator+( String^ str1, String^ str2)  

ParameterParameters

str1
Das erste String-Objekt.The first String object.

str2
Das zweite String-Objekt, dessen Inhalt str1 angefügt wird.The second String object, whose contents will be appended to str1.

RückgabewertReturn Value

true, wenn str1 und str2 gleich sind, andernfalls false.true if str1 is equal to str2; otherwise, false.

HinweiseRemarks

Dieser Operator erstellt ein String^-Objekt mit den Daten aus den zwei Operanden.This operator creates a String^ object that contains the data from the two operands. Verwenden Sie es zur Vereinfachung, wenn nicht unbedingt extreme Leistung gefordert ist.Use it for convenience when extreme performance is not critical. Einige Aufrufe von "+" in einer Funktion werden sich wahrscheinlich nicht bemerkbar machen. Wenn Sie jedoch große Objekte oder Textdaten in einer kurzen Schleife bearbeiten, sollten Sie die standardmäßigen C++-Mechanismen und -typen verwenden.A few calls to "+" in a function will probably not be noticeable, but if you are manipulating large objects or text data in a tight loop, then use the standard C++ mechanisms and types.

String:: Operator ==-Operator String::operator== Operator

Gibt an, ob zwei angegebene Zeichenfolgenobjekte denselben Textwert haben.Indicates whether two specified String objects have the same text value.

SyntaxSyntax

bool String::operator==( String^ str1, String^ str2)  

ParameterParameters

str1
Das erste zu vergleichende Zeichenfolgenobjekt.The first String object to compare.

str2
Das zweite zu vergleichende Zeichenfolgenobjekt.The second String object to compare.

RückgabewertReturn Value

true, wenn der Inhalt von str1 gleich str2 ist; andernfalls false.true if the contents of str1 are equal to str2; otherwise, false.

HinweiseRemarks

Dieser Operator entspricht String:: CompareOrdinal.This operator is equivalent to String::CompareOrdinal.

String:: Operator>String::operator>

Gibt an, ob der Wert eines Zeichenfolgenobjekts größer als der Wert eines zweiten Zeichenfolgenobjekts ist.Indicates whether the value of one String object is greater than the value of a second String object.

SyntaxSyntax

bool String::operator>( String^ str1, String^ str2)  

ParameterParameters

str1
Das erste String-Objekt.The first String object.

str2
Das zweite String-Objekt.The second String object.

RückgabewertReturn Value

true, wenn der Wert von str1 größer als der Wert von str2 ist, andernfalls false.true if the value of str1 is greater than the value of str2; otherwise, false.

HinweiseRemarks

Dieser Operator entspricht einem expliziten Aufruf von String:: CompareOrdinal und ein Ergebnis größer als 0 (null) abrufen.This operator is equivalent to explicitly calling String::CompareOrdinal and getting a result greater than zero.

String::operator>=String::operator>=

Gibt an, ob der Wert eines String-Objekts größer oder gleich dem Wert eines zweiten String-Objekts ist.Indicates whether the value of one String object is greater than or equal to the value of a second String object.

SyntaxSyntax

bool String::operator>=( String^ str1, String^ str2) 

ParameterParameters

str1
Das erste String-Objekt.The first String object.

str2
Das zweite String-Objekt.The second String object.

RückgabewertReturn Value

true, wenn der Wert von str1 größer oder gleich dem Wert von str2 ist, andernfalls false.true if the value of str1 is greater than or equal to the value of str2; otherwise, false.

String:: Operator! =String::operator!=

Gibt an, ob zwei angegebene Zeichenfolgenobjekte unterschiedliche Werte haben.Indicates whether two specifed String objects have different values.

SyntaxSyntax

bool String::operator!=( String^ str1, String^ str2)  

ParameterParameters

str1
Das erste zu vergleichende Zeichenfolgenobjekt.The first String object to compare.

str2
Das zweite zu vergleichende Zeichenfolgenobjekt.The second String object to compare.

RückgabewertReturn Value

true, wenn str1 und str2 ungleich sind, andernfalls false.true if str1 is not equal to str2; otherwise, false.

String::operator<String::operator<

Gibt an, ob der Wert eines Zeichenfolgenobjekts kleiner als der Wert eines zweiten Zeichenfolgenobjekts ist.Indicates whether the value of one String object is less than the value of a second String object.

SyntaxSyntax

bool String::operator<( String^ str1, String^ str2)  

ParameterParameters

str1
Das erste String-Objekt.The first String object.

str2
Das zweite String-Objekt.The second String object.

RückgabewertReturn Value

true, wenn der Wert von str1 kleiner als der Wert von str2 ist, andernfalls false.true if the value of str1 is less than the value of str2; otherwise, false.

String:: String-KonstruktorString::String Constructor

Initialisiert eine neue Instanz der Zeichenfolgenklasse mit einer Kopie der Eingabezeichenfolgendaten.Initializes a new instance of the String class with a copy of the input string data.

SyntaxSyntax

String();    
String(char16* s)  
String(char16* s, unsigned int n)  

ParameterParameters

s
Eine Reihe von Breitzeichen, die die Zeichenfolge initialisieren.A series of wide characters that initialize the string. char16char16

n
Eine Zahl, die die Länge der Zeichenfolge angibt.A number that specifies the length of the string.

HinweiseRemarks

Wenn die Leistung kritisch ist und Sie die Lebensdauer der Quellzeichenfolge kontrollieren, können Sie Platform:: stringreference anstelle der Zeichenfolge.If performance is critical and you control the lifetime of the source string, you can use Platform::StringReference in place of String.

BeispielExample

String^ s = L"Hello!";  

String::ToStringString::ToString

Gibt ein neues Zeichenfolgenobjekt zurück, dessen Wert mit der aktuellen Zeichenfolge identisch ist.Returns a String object whose value is the same as the current string.

SyntaxSyntax

String^ String::ToString()  

RückgabewertReturn Value

Ein Zeichenfolgenobjekt, dessen Wert mit der aktuellen Zeichenfolge identisch ist.A String object whose value is the same as the current string.

Siehe auchSee Also

PlattformnamespacePlatform namespace