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 beteiligt ist eine Schnelldurchlauf Vorgang.Indicates whether the current String object 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 (Min.): Windows 8Minimum supported client: Windows 8

Unterstützter Server (Min.): 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

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

str2str2
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

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

str2str2
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 null und str2 ungleich null ist, wird str1 zurückgegeben.If str1 is null and str2 is not, str1 is returned. Wenn str2 null und str1 ungleich null ist, wird str2 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 das Array in den Speicher zu kopieren, 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

strstr
Das zu vergleichende Objekt.The object to compare.

RückgabewertReturn Value

"true" Wenn str ist 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 die aktuelle String Objekt null oder eine 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 beteiligt ist eine Schnelldurchlauf Vorgang.Indicates whether the current String object 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 die aktuelle String Objekt ist Fast-Pass; 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 der Zeichen in der aktuellen String Objekt.Retrieves the number of characters in the current String object.

SyntaxSyntax

unsigned int Length();

RückgabewertReturn Value

Die Anzahl der Zeichen in der aktuellen String Objekt.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 Zeichenarray, das zurückgegeben werden, indem die String:: Data verfügt über ein zusätzliches Zeichen, das 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 die beiden Zeichenfolge Objekte in ein neues Zeichenfolge Objekt.Concatenates two String objects into a new String object.

SyntaxSyntax

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

ParameterParameters

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

str2str2
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 gleich str2ist, 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 ==-OperatorString::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

str1str1
Das erste zu vergleichende String-Objekt.The first String object to compare.

str2str2
Das zweite zu vergleichende String-Objekt.The second String object to compare.

RückgabewertReturn Value

"true" Wenn der Inhalt des str1 gleich str2ist, 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 String -Quellobjekt ist größer als der Wert eines zweiten String Objekt.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

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

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

RückgabewertReturn Value

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

HinweiseRemarks

Dieser Operator entspricht beim expliziten Aufruf String:: CompareOrdinal und erhalten ein Ergebnis größer als 0 (null).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 Objekt ist größer als oder gleich dem Wert eines zweiten String Objekt.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

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

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

RückgabewertReturn Value

"true" Wenn der Wert des str1 ist größer als oder gleich dem Wert des str2ist, 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 String -Objekte verschiedene Werte haben.Indicates whether two specifed String objects have different values.

SyntaxSyntax

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

ParameterParameters

str1str1
Das erste zu vergleichende String-Objekt.The first String object to compare.

str2str2
Das zweite zu vergleichende String-Objekt.The second String object to compare.

RückgabewertReturn Value

"true" Wenn str1 ist nicht gleich str2ist, andernfalls "false".true if str1 is not equal to str2; otherwise, false.

String:: Operator<String::operator<

Gibt an, ob der Wert eines String Objekt ist kleiner als der Wert eines zweiten String Objekt.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

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

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

RückgabewertReturn Value

"true" Wenn der Wert des str1 ist kleiner als der Wert des str2ist, 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 dem String Klasse 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

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

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

HinweiseRemarks

Wenn Leistung wichtig ist, und Sie die Lebensdauer der Quellzeichenfolge steuern, 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 eine String Objekt, dessen Wert der aktuellen Zeichenfolge identisch.Returns a String object whose value is the same as the current string.

SyntaxSyntax

String^ String::ToString();

RückgabewertReturn Value

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

Siehe auchSee Also

Platform-namespacePlatform namespace