String.Intern(String) String.Intern(String) String.Intern(String) String.Intern(String) Method

Definition

Ruft den Verweis des Systems auf den angegebenen String ab.Retrieves the system's reference to the specified String.

public:
 static System::String ^ Intern(System::String ^ str);
public static string Intern (string str);
static member Intern : string -> string
Public Shared Function Intern (str As String) As String

Parameter

str
String String String String

Eine im Internpool zu suchende Zeichenfolge.A string to search for in the intern pool.

Gibt zurück

Der Verweis des Systems auf str, wenn dieser im Internpool vorhanden ist, andernfalls ein neuer Verweis auf eine Zeichenfolge mit dem Wert von str.The system's reference to str, if it is interned; otherwise, a new reference to a string with the value of str.

Ausnahmen

Beispiele

Das folgende Beispiel verwendet drei Zeichenfolgen, die Wert zu bestimmen, ob eine neu erstellte Zeichenfolge identisch ist, und eine im Internpool vorhanden Zeichenfolge sind gleich.The following example uses three strings that are equal in value to determine whether a newly created string and an interned string are equal.

// Sample for String::Intern(String)
using namespace System;
using namespace System::Text;
int main()
{
   String^ s1 = "MyTest";
   String^ s2 = (gcnew StringBuilder)->Append( "My" )->Append( "Test" )->ToString();
   String^ s3 = String::Intern( s2 );
   Console::WriteLine( "s1 == '{0}'", s1 );
   Console::WriteLine( "s2 == '{0}'", s2 );
   Console::WriteLine( "s3 == '{0}'", s3 );
   Console::WriteLine( "Is s2 the same reference as s1?: {0}", s2 == s1 );
   Console::WriteLine( "Is s3 the same reference as s1?: {0}", s3 == s1 );
}

/*
This example produces the following results:
s1 == 'MyTest'
s2 == 'MyTest'
s3 == 'MyTest'
Is s2 the same reference as s1?: False
Is s3 the same reference as s1?: True
*/
// Sample for String.Intern(String)
using System;
using System.Text;

class Sample {
    public static void Main() {
    String s1 = "MyTest";
    String s2 = new StringBuilder().Append("My").Append("Test").ToString(); 
    String s3 = String.Intern(s2); 
    Console.WriteLine("s1 == '{0}'", s1);
    Console.WriteLine("s2 == '{0}'", s2);
    Console.WriteLine("s3 == '{0}'", s3);
    Console.WriteLine("Is s2 the same reference as s1?: {0}", (Object)s2==(Object)s1); 
    Console.WriteLine("Is s3 the same reference as s1?: {0}", (Object)s3==(Object)s1);
    }
}
/*
This example produces the following results:
s1 == 'MyTest'
s2 == 'MyTest'
s3 == 'MyTest'
Is s2 the same reference as s1?: False
Is s3 the same reference as s1?: True
*/
' Sample for String.Intern(String)
Imports System
Imports System.Text

Class Sample
   
   Public Shared Sub Main()
      Dim s1 As [String] = "MyTest"
      Dim s2 As [String] = New StringBuilder().Append("My").Append("Test").ToString()
      Dim s3 As [String] = [String].Intern(s2)
      Console.WriteLine("s1 = '{0}'", s1)
      Console.WriteLine("s2 = '{0}'", s2)
      Console.WriteLine("s3 = '{0}'", s3)
      Console.WriteLine("Is s2 the same reference as s1?: {0}", s2 Is s1)
      Console.WriteLine("Is s3 the same reference as s1?: {0}", s3 Is s1)
   End Sub 'Main
End Class 'Sample
'
's1 = 'MyTest'
's2 = 'MyTest'
's3 = 'MyTest'
'Is s2 the same reference as s1?: False
'Is s3 the same reference as s1?: True
'

Hinweise

Die common Language Runtime behält Zeichenfolgenspeicher durch verwalten eine Tabelle, mit dem Namen Internpool, die einen einzelnen Verweis auf jedes eindeutigen Zeichenfolgenliterals deklariert oder programmgesteuert erstellt, in Ihrem Programm enthält.The common language runtime conserves string storage by maintaining a table, called the intern pool, that contains a single reference to each unique literal string declared or created programmatically in your program. Daher vorhanden eine Instanz einer Literalzeichenfolge mit einem bestimmten Wert nur einmal im System.Consequently, an instance of a literal string with a particular value only exists once in the system.

Beispielsweise, wenn Sie mehrere Variablen, die die gleiche Zeichenfolge zuweisen, die Runtime Ruft den gleichen Verweis auf das Zeichenfolgenliteral aus Internpool und jeder Variablen zugewiesen.For example, if you assign the same literal string to several variables, the runtime retrieves the same reference to the literal string from the intern pool and assigns it to each variable.

Die Intern Methode verwendet Internpool um zu suchende eine Zeichenfolge, die gleich dem Wert des str.The Intern method uses the intern pool to search for a string equal to the value of str. Wenn eine solche Zeichenfolge vorhanden ist, wird der Verweis im Internpool zurückgegeben.If such a string exists, its reference in the intern pool is returned. Wenn die Zeichenfolge nicht vorhanden ist, einen Verweis auf str dem Internpool hinzugefügt wird, und klicken Sie dann diesen Verweis zurückgegeben wird.If the string does not exist, a reference to str is added to the intern pool, then that reference is returned.

Im folgenden Beispiel wird der Zeichenfolge s1 mit die Wert "MyTest", bereits intern gespeichert, da es sich um ein Literal in der Anwendung handelt.In the following example, the string s1, which has a value of "MyTest", is already interned because it is a literal in the program. Die System.Text.StringBuilder Klasse generiert ein neues Zeichenfolgenobjekt, das den gleichen Wert wie bei s1 verfügt.The System.Text.StringBuilder class generates a new string object that has the same value as s1. Ein Verweis auf diese Zeichenfolge wird auf s2 Herunterskalieren zugewiesen.A reference to that string is assigned to s2. Die Intern Methode sucht eine Zeichenfolge, die den gleichen Wert wie s2 hat.The Intern method searches for a string that has the same value as s2. Da eine solche Zeichenfolge vorhanden ist, gibt die Methode den gleichen Verweis, der auf s1 zugewiesen ist.Because such a string exists, the method returns the same reference that is assigned to s1. Dieser Verweis wird dann auf s3 zugewiesen.That reference is then assigned to s3. Verweise s1 und s2 sind ungleich, da sie auf verschiedene Objekte verweisen. Verweise s1 und s3 sind gleich, da sie auf die gleiche Zeichenfolge verweisen.References s1 and s2 compare unequal because they refer to different objects; references s1 and s3 compare equal because they refer to the same string.

string s1 = "MyTest"; 
string s2 = new StringBuilder().Append("My").Append("Test").ToString(); 
string s3 = String.Intern(s2); 
Console.WriteLine((Object)s2==(Object)s1); // Different references.
Console.WriteLine((Object)s3==(Object)s1); // The same reference.
Dim s1 As String = "MyTest" 
Dim s2 As String = New StringBuilder().Append("My").Append("Test").ToString() 
Dim s3 As String = String.Intern(s2) 
Console.WriteLine(CObj(s2) Is CObj(s1))      ' Different references.
Console.WriteLine(CObj(s3) Is CObj(s1))      ' The same reference.

Vergleichen Sie diese Methode, um die IsInterned Methode.Compare this method to the IsInterned method.

Version-ÜberlegungenVersion Considerations

In der .NET Framework 3.5 Service Pack 1.NET Framework 3.5 Service Pack 1, Intern Methode auf das Verhalten in .NET Framework 1.0 und 1.1 im Hinblick auf eine Internalisierung die leere Zeichenfolge zurückgesetzt.In the .NET Framework 3.5 Service Pack 1.NET Framework 3.5 Service Pack 1, the Intern method reverts to its behavior in the .NET Framework 1.0 and 1.1 with regard to interning the empty string. In der folgenden Beispiel wird die Variable str1 erhält einen Verweis auf Empty, und die Variable str2 erhält den Verweis auf Empty zurückgegeben, die durch Aufrufen der Intern Methode nach der Konvertierung einer StringBuilderObjekt, dessen Wert Empty in eine Zeichenfolge.In the following example, the variable str1 is assigned a reference to Empty, and the variable str2 is assigned the reference to Empty that is returned by calling the Intern method after converting a StringBuilder object whose value is Empty to a string. Klicken Sie dann die Verweise, die in enthaltenen str1 und str2 Gleichheit verglichen werden.Then the references contained in str1 and str2 are compared for equality.

string str1 = String.Empty;
string str2 = String.Empty;

StringBuilder sb = new StringBuilder().Append(String.Empty);
str2 = String.Intern(sb.ToString());	

if((object)str1==(object)str2)
	Console.WriteLine("The strings are equal.");
else
	Console.WriteLine("The strings are not equal.");
Dim str1 As String = String.Empty
Dim str2 As String = String.Empty

Dim sb As StringBuilder = New StringBuilder().Append(String.Empty)
str2 = String.Intern(sb.ToString())	

If CObj(str1) Is CObj(str2) Then
	Console.WriteLine("The strings are equal.")
Else
	Console.WriteLine("The strings are not equal.")
End If	

In der .NET Framework 1.0.NET Framework 1.0, .NET Framework 1.1.NET Framework 1.1, und .NET Framework 3.5 SP1.NET Framework 3.5 SP1, str1 und str2 gleich sind.In the .NET Framework 1.0.NET Framework 1.0, .NET Framework 1.1.NET Framework 1.1, and .NET Framework 3.5 SP1.NET Framework 3.5 SP1, str1 and str2 are equal. In der .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1 und .NET Framework 3.0.NET Framework 3.0, str1 und str2 ungleich sind.In the .NET Framework 2.0 Service Pack 1.NET Framework 2.0 Service Pack 1 and .NET Framework 3.0.NET Framework 3.0, str1 and str2 are not equal.

Überlegungen zur LeistungPerformance Considerations

Wenn Sie versuchen, die die Gesamtmenge des Arbeitsspeichers zu reduzieren. Ihre Anwendung weist, denken Sie daran, die Internalisieren von Zeichenfolgen zwei unerwünschte Nebeneffekte hat.If you are trying to reduce the total amount of memory your application allocates, keep in mind that interning a string has two unwanted side effects. Zunächst der zugeordnete Arbeitsspeicher für internalisiert String Objekte wahrscheinlich nicht freigegeben werden, bis die common Language Runtime (CLR) beendet wird.First, the memory allocated for interned String objects is not likely to be released until the common language runtime (CLR) terminates. Der Grund dafür ist, die der CLR-Verweis auf das internalisierte String Objekt können beibehalten, nachdem die Anwendung oder sogar der Anwendungsdomäne, beendet wird.The reason is that the CLR's reference to the interned String object can persist after your application, or even your application domain, terminates. Um eine Zeichenfolge intern, müssen Sie zweitens zunächst die Zeichenfolge erstellen.Second, to intern a string, you must first create the string. Der Speicher ein, die die String Objekt muss immer noch zugeordnet werden können, auch wenn der Arbeitsspeicher schließlich Garbage Collection durchgeführt wird.The memory used by the String object must still be allocated, even though the memory will eventually be garbage collected.

.NET Framework, Version 2.0 stellt die CompilationRelaxations.NoStringInterning -Enumerationsmember.The .NET Framework version 2.0 introduces the CompilationRelaxations.NoStringInterning enumeration member. Die NoStringInterning Element markiert eine Assembly nicht eine erforderliche Zeichenfolge interning von.The NoStringInterning member marks an assembly as not requiring string-literal interning. Sie anwenden können NoStringInterning auf eine Assembly mit der CompilationRelaxationsAttribute Attribut.You can apply NoStringInterning to an assembly using the CompilationRelaxationsAttribute attribute. Wenn Sie darüber hinaus verwenden die Ngen.exe (Native Image Generator) zum Kompilieren einer Assembly im Vorfeld zur Laufzeit Zeichenfolgen nicht modulübergreifend Module.Also, when you use the Ngen.exe (Native Image Generator) to compile an assembly in advance of run time, strings are not interned across modules.

Gilt für:

Siehe auch