String.Substring Methode

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Ruft eine Teilzeichenfolge aus dieser Instanz ab.

Dieses Element wird überladen. Um vollständige Informationen zu diesem Element zu erfahren, einschließlich Syntax, Verwendung und Beispiele, klicken Sie in der Überladungsliste auf einen Namen.

Überlädt

Name	Beschreibung
Substring(Int32)	Ruft eine Teilzeichenfolge aus dieser Instanz ab. Die Teilzeichenfolge beginnt an einer angegebenen Zeichenposition und setzt das Ende der Zeichenfolge fort.
Substring(Int32, Int32)	Ruft eine Teilzeichenfolge aus dieser Instanz ab. Die Teilzeichenfolge beginnt an einer angegebenen Zeichenposition und hat eine angegebene Länge.

Substring(Int32)

Quelle:

String.Manipulation.cs

Ruft eine Teilzeichenfolge aus dieser Instanz ab. Die Teilzeichenfolge beginnt an einer angegebenen Zeichenposition und setzt das Ende der Zeichenfolge fort.

public:
 System::String ^ Substring(int startIndex);

public string Substring(int startIndex);

member this.Substring : int -> string

Public Function Substring (startIndex As Integer) As String

Parameter

startIndex

Int32

Die nullbasierte Anfangszeichenposition einer Teilzeichenfolge in dieser Instanz.

Gibt zurück

String

Eine Zeichenfolge, die der Teilzeichenfolge entspricht, die in startIndex dieser Instanz beginnt oder Empty gleich startIndex der Länge dieser Instanz ist.

Ausnahmen

ArgumentOutOfRangeException

startIndex ist kleiner als Null oder größer als die Länge dieser Instanz.

Beispiele

Das folgende Beispiel veranschaulicht das Abrufen einer Teilzeichenfolge aus einer Zeichenfolge.

string [] info = { "Name: Felica Walker", "Title: Mz.", 
                   "Age: 47", "Location: Paris", "Gender: F"};
int found = 0;

Console.WriteLine("The initial values in the array are:");
foreach (string s in info)
    Console.WriteLine(s);

Console.WriteLine("\nWe want to retrieve only the key information. That is:");        
foreach (string s in info) 
{
    found = s.IndexOf(": ");
    Console.WriteLine("   {0}", s.Substring(found + 2));
}

// The example displays the following output:
//       The initial values in the array are:
//       Name: Felica Walker
//       Title: Mz.
//       Age: 47
//       Location: Paris
//       Gender: F
//       
//       We want to retrieve only the key information. That is:
//          Felica Walker
//          Mz.
//          47
//          Paris
//          F

let info = 
    [| "Name: Felica Walker"; "Title: Mz."
       "Age: 47"; "Location: Paris"; "Gender: F" |]

printfn "The initial values in the array are:"
for s in info do
    printfn $"{s}"

printfn "\nWe want to retrieve only the key information. That is:"
for s in info do
    let found = s.IndexOf ": "
    printfn $"   {s.Substring(found + 2)}"

// The example displays the following output:
//       The initial values in the array are:
//       Name: Felica Walker
//       Title: Mz.
//       Age: 47
//       Location: Paris
//       Gender: F
//
//       We want to retrieve only the key information. That is:
//          Felica Walker
//          Mz.
//          47
//          Paris
//          F

Public Class SubStringTest
    Public Shared Sub Main()
        Dim info As String() = { "Name: Felica Walker", "Title: Mz.", 
                                 "Age: 47", "Location: Paris", "Gender: F"}
        Dim found As Integer = 0
       
        Console.WriteLine("The initial values in the array are:")
        For Each s As String In info
            Console.WriteLine(s)
        Next s

        Console.WriteLine(vbCrLf + "We want to retrieve only the key information. That is:")
        For Each s As String In info
            found = s.IndexOf(": ")
            Console.WriteLine("   {0}", s.Substring(found + 2))
        Next s
    End Sub 
End Class 
' The example displays the following output:
'       The initial values in the array are:
'       Name: Felica Walker
'       Title: Mz.
'       Age: 47
'       Location: Paris
'       Gender: F
'       
'       We want to retrieve only the key information. That is:
'          Felica Walker
'          Mz.
'          47
'          Paris
'          F

Im folgenden Beispiel wird die Substring Methode verwendet, um Schlüssel-Wert-Paare zu trennen, die durch ein Gleichheitszeichen (=) getrennt werden.

String[] pairs = { "Color1=red", "Color2=green", "Color3=blue",
                 "Title=Code Repository" };
foreach (var pair in pairs) 
{
    int position = pair.IndexOf("=");
    if (position < 0)
        continue;
    Console.WriteLine("Key: {0}, Value: '{1}'", 
                   pair.Substring(0, position),
                   pair.Substring(position + 1));
}                          

// The example displays the following output:
//     Key: Color1, Value: 'red'
//     Key: Color2, Value: 'green'
//     Key: Color3, Value: 'blue'
//     Key: Title, Value: 'Code Repository'

let pairs = 
    [| "Color1=red"; "Color2=green"; "Color3=blue"
       "Title=Code Repository" |]
for pair in pairs do
    let position = pair.IndexOf "="
    if position >= 0 then
        printfn $"Key: {pair.Substring(0, position)}, Value: '{pair.Substring(position + 1)}'"

// The example displays the following output:
//     Key: Color1, Value: 'red'
//     Key: Color2, Value: 'green'
//     Key: Color3, Value: 'blue'
//     Key: Title, Value: 'Code Repository'

Module Example
   Public Sub Main()
      Dim pairs() As String = { "Color1=red", "Color2=green", "Color3=blue",
                                "Title=Code Repository" }
      For Each pair In pairs
         Dim position As Integer = pair.IndexOf("=")
         If position < 0 then Continue For
         Console.WriteLine("Key: {0}, Value: '{1}'", 
                           pair.Substring(0, position),
                           pair.Substring(position + 1))
      Next                          
   End Sub
End Module
' The example displays the following output:
'     Key: Color1, Value: 'red'
'     Key: Color2, Value: 'green'
'     Key: Color3, Value: 'blue'
'     Key: Title, Value: 'Code Repository'

Die IndexOf Methode wird verwendet, um die Position des Gleichheitszeichens in der Zeichenfolge abzurufen. Der Aufruf der Substring(Int32, Int32) Methode extrahiert den Schlüsselnamen, der vom ersten Zeichen in der Zeichenfolge beginnt und für die Anzahl der vom Aufruf der IndexOf Methode zurückgegebenen Zeichen erweitert wird. Der Aufruf der Substring(Int32) Methode extrahiert dann den dem Schlüssel zugewiesenen Wert. Sie beginnt mit einer Zeichenposition über das Gleichheitszeichen hinaus und erstreckt sich bis zum Ende der Zeichenfolge.

Hinweise

Sie rufen die Substring(Int32) Methode auf, um eine Teilzeichenfolge aus einer Zeichenfolge zu extrahieren, die an einer angegebenen Zeichenposition beginnt und am Ende der Zeichenfolge endet. Die Anfangszeichenposition ist nullbasiert; Mit anderen Worten, das erste Zeichen in der Zeichenfolge befindet sich bei Index 0, nicht index 1. Um eine Teilzeichenfolge zu extrahieren, die an einer angegebenen Zeichenposition beginnt und vor dem Ende der Zeichenfolge endet, rufen Sie die Substring(Int32, Int32) Methode auf.

Note

Diese Methode ändert nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge zurückgegeben, die an der Position in der startIndex aktuellen Zeichenfolge beginnt.

Um eine Teilzeichenfolge zu extrahieren, die mit einem bestimmten Zeichen oder einer bestimmten Zeichensequenz beginnt, rufen Sie eine Methode auf, z IndexOf . B. oder IndexOf um den Wert von startIndex. Das zweite Beispiel veranschaulicht dies; es extrahiert einen Schlüsselwert, der nach dem = Zeichen eine Zeichenposition beginnt.

Wenn startIndex gleich Null ist, gibt die Methode die ursprüngliche Zeichenfolge unverändert zurück.

Weitere Informationen

• Int32
• Concat(Object)
• Insert(Int32, String)
• Join(String, String[])
• Remove(Int32, Int32)
• Replace(Char, Char)
• Split(Char[])
• Trim(Char[])

Substring(Int32, Int32)

Quelle:

String.Manipulation.cs

Ruft eine Teilzeichenfolge aus dieser Instanz ab. Die Teilzeichenfolge beginnt an einer angegebenen Zeichenposition und hat eine angegebene Länge.

public:
 System::String ^ Substring(int startIndex, int length);

public string Substring(int startIndex, int length);

member this.Substring : int * int -> string

Public Function Substring (startIndex As Integer, length As Integer) As String

Parameter

startIndex

Int32

Die nullbasierte Anfangszeichenposition einer Teilzeichenfolge in dieser Instanz.

length

Int32

Die Anzahl der Zeichen in der Teilzeichenfolge.

Gibt zurück

String

Eine Zeichenfolge, die der Teilzeichenfolge der Länge length entspricht, die in startIndex dieser Instanz beginnt oder Empty gleich startIndex der Länge dieser Instanz ist und length null ist.

Ausnahmen

ArgumentOutOfRangeException

startIndex plus length gibt eine Position an, die sich nicht innerhalb dieser Instanz befindet.

-oder-

startIndex oder length ist kleiner als Null.

Beispiele

Im folgenden Beispiel wird ein einfacher Aufruf der Methode veranschaulicht, der Substring(Int32, Int32) zwei Zeichen aus einer Zeichenfolge extrahiert, die an der sechsten Zeichenposition beginnt (d. a. bei Index 5).

String value = "This is a string.";
int startIndex = 5;
int length = 2;
String substring = value.Substring(startIndex, length);
Console.WriteLine(substring);

// The example displays the following output:
//       is

let value = "This is a string."
let startIndex = 5
let length = 2
let substring = value.Substring(startIndex, length)
printfn $"{substring}"

// The example displays the following output:
//       is

Module Example
   Public Sub Main()
      Dim value As String = "This is a string."
      Dim startIndex As Integer = 5
      Dim length As Integer = 2
      Dim substring As String = value.Substring(startIndex, length)
      Console.WriteLine(substring)
   End Sub
End Module
' The example displays the following output:
'       is

Im folgenden Beispiel wird die Substring(Int32, Int32) Methode in den folgenden drei Fällen verwendet, um Teilzeichenfolgen innerhalb einer Zeichenfolge zu isolieren. In zwei Fällen werden die Teilzeichenfolgen in Vergleichen verwendet, und im dritten Fall wird eine Ausnahme ausgelöst, da ungültige Parameter angegeben werden.

• Es extrahiert das einzelne Zeichen an der dritten Position in der Zeichenfolge (bei Index 2) und vergleicht es mit einem "c". Dieser Vergleich gibt zurück true.

• Es extrahiert Nullzeichen beginnend an der vierten Position in der Zeichenfolge (bei Index 3) und übergibt sie an die IsNullOrEmpty Methode. Dies gibt true zurück, da der Aufruf der Substring Methode zurückgegeben wird String.Empty.

• Es versucht, ein Zeichen zu extrahieren, das an der vierten Position in der Zeichenfolge beginnt. Da an dieser Position kein Zeichen vorhanden ist, löst der Methodenaufruf eine Ausnahme aus ArgumentOutOfRangeException .

string myString = "abc";
bool test1 = myString.Substring(2, 1).Equals("c"); // This is true.
Console.WriteLine(test1);
bool test2 = string.IsNullOrEmpty(myString.Substring(3, 0)); // This is true.
Console.WriteLine(test2);
try
{
   string str3 = myString.Substring(3, 1); // This throws ArgumentOutOfRangeException.
   Console.WriteLine(str3);
}
catch (ArgumentOutOfRangeException e)
{
   Console.WriteLine(e.Message);
}

// The example displays the following output:
//       True
//       True
//       Index and length must refer to a location within the string.
//       Parameter name: length

let myString = "abc"
let test1 = myString.Substring(2, 1).Equals "c" // This is true.
printfn $"{test1}"
let test2 = String.IsNullOrEmpty(myString.Substring(3, 0)) // This is true.
printfn $"{test2}"
try
    let str3 = myString.Substring(3, 1) // This throws ArgumentOutOfRangeException.
    printfn $"{str3}"
with :? ArgumentOutOfRangeException as e ->
    printfn $"{e.Message}"

// The example displays the following output:
//       True
//       True
//       Index and length must refer to a location within the string.
//       Parameter name: length

Public Class Sample
   Public Shared Sub Main()
      Dim myString As String = "abc"
      Dim test1 As Boolean = myString.Substring(2, 1).Equals("c") ' This is true.
      Console.WriteLine(test1)
      Dim test2 As Boolean = String.IsNullOrEmpty(myString.Substring(3, 0)) ' This is true.
      Console.WriteLine(test2)
      Try  
         Dim str3 As String = myString.Substring(3, 1) ' This throws ArgumentOutOfRangeException.
         Console.WriteLine(str3)
      Catch e As ArgumentOutOfRangeException
         Console.WriteLIne(e.Message)
      End Try   
   End Sub
End Class 
' The example displays the following output:
'       True
'       True
'       Index and length must refer to a location within the string.
'       Parameter name: length

Im folgenden Beispiel wird die Substring Methode verwendet, um Schlüssel-Wert-Paare zu trennen, die durch ein Gleichheitszeichen (=) getrennt werden.

String[] pairs = { "Color1=red", "Color2=green", "Color3=blue",
                 "Title=Code Repository" };
foreach (var pair in pairs) 
{
    int position = pair.IndexOf("=");
    if (position < 0)
        continue;
    Console.WriteLine("Key: {0}, Value: '{1}'", 
                   pair.Substring(0, position),
                   pair.Substring(position + 1));
}                          

// The example displays the following output:
//     Key: Color1, Value: 'red'
//     Key: Color2, Value: 'green'
//     Key: Color3, Value: 'blue'
//     Key: Title, Value: 'Code Repository'

let pairs = 
    [| "Color1=red"; "Color2=green"; "Color3=blue"
       "Title=Code Repository" |]
for pair in pairs do
    let position = pair.IndexOf "="
    if position >= 0 then
        printfn $"Key: {pair.Substring(0, position)}, Value: '{pair.Substring(position + 1)}'"

// The example displays the following output:
//     Key: Color1, Value: 'red'
//     Key: Color2, Value: 'green'
//     Key: Color3, Value: 'blue'
//     Key: Title, Value: 'Code Repository'

Module Example
   Public Sub Main()
      Dim pairs() As String = { "Color1=red", "Color2=green", "Color3=blue",
                                "Title=Code Repository" }
      For Each pair In pairs
         Dim position As Integer = pair.IndexOf("=")
         If position < 0 then Continue For
         Console.WriteLine("Key: {0}, Value: '{1}'", 
                           pair.Substring(0, position),
                           pair.Substring(position + 1))
      Next                          
   End Sub
End Module
' The example displays the following output:
'     Key: Color1, Value: 'red'
'     Key: Color2, Value: 'green'
'     Key: Color3, Value: 'blue'
'     Key: Title, Value: 'Code Repository'

Die IndexOf Methode wird verwendet, um die Position des Gleichheitszeichens in der Zeichenfolge abzurufen. Der Aufruf der Substring(Int32, Int32) Methode extrahiert den Schlüsselnamen, der vom ersten Zeichen in der Zeichenfolge beginnt und für die Anzahl der vom Aufruf der IndexOf Methode zurückgegebenen Zeichen erweitert wird. Der Aufruf der Substring(Int32) Methode extrahiert dann den dem Schlüssel zugewiesenen Wert. Sie beginnt mit einer Zeichenposition über das Gleichheitszeichen hinaus und erstreckt sich bis zum Ende der Zeichenfolge.

Hinweise

Sie rufen die Substring(Int32, Int32) Methode auf, um eine Teilzeichenfolge aus einer Zeichenfolge zu extrahieren, die an einer angegebenen Zeichenposition beginnt und vor dem Ende der Zeichenfolge endet. Die Anfangszeichenposition ist nullbasiert; Mit anderen Worten, das erste Zeichen in der Zeichenfolge befindet sich bei Index 0, nicht index 1. Rufen Sie die Substring(Int32) Methode auf, um eine Teilzeichenfolge zu extrahieren, die an einer angegebenen Zeichenposition beginnt und am Ende der Zeichenfolge fortgesetzt wird.

Note

Diese Methode ändert nicht den Wert der aktuellen Instanz. Stattdessen wird eine neue Zeichenfolge mit length Zeichen zurückgegeben, die von der Position in der startIndex aktuellen Zeichenfolge beginnen.

Der length Parameter stellt die Gesamtzahl der Zeichen dar, die aus der aktuellen Zeichenfolgeninstanz extrahiert werden sollen. Dies schließt das Startzeichen ein, das im Index startIndexgefunden wird. Mit anderen Worten, die Substring Methode versucht, Zeichen aus Index startIndex in Index startIndex + length - 1 zu extrahieren.

Um eine Teilzeichenfolge zu extrahieren, die mit einem bestimmten Zeichen oder einer bestimmten Zeichensequenz beginnt, rufen Sie eine Methode auf, z IndexOf . B. oder LastIndexOf um den Wert von startIndex.

Wenn die Teilzeichenfolge von startIndex zu einer angegebenen Zeichenfolge erweitert werden soll, können Sie eine Methode aufrufen, z IndexOf . B. oder LastIndexOf um den Index des Endzeichens oder der Zeichensequenz abzurufen. Sie können diesen Wert dann wie folgt in eine Indexposition in der Zeichenfolge konvertieren:

• Wenn Sie nach einem einzelnen Zeichen gesucht haben, das das Ende der Teilzeichenfolge markieren soll, entsprichtlengthendIndex - der startIndex Parameter +1, wobei endIndex der Rückgabewert der IndexOf Oder-Methode LastIndexOf ist. Im folgenden Beispiel wird ein fortlaufender Block von "b"-Zeichen aus einer Zeichenfolge extrahiert.

  String s = "aaaaabbbcccccccdd";
  Char charRange = 'b';
  int startIndex = s.IndexOf(charRange);
  int endIndex = s.LastIndexOf(charRange);
  int length = endIndex - startIndex + 1;
  Console.WriteLine("{0}.Substring({1}, {2}) = {3}",
                  s, startIndex, length, 
                  s.Substring(startIndex, length));
  
  // The example displays the following output:
  //       aaaaabbbcccccccdd.Substring(5, 3) = bbb
  

  let s = "aaaaabbbcccccccdd"
  let charRange = 'b'
  let startIndex = s.IndexOf charRange
  let endIndex = s.LastIndexOf charRange
  let length = endIndex - startIndex + 1
  printfn $"{s}.Substring({startIndex}, {length}) = {s.Substring(startIndex, length)}"
  
  // The example displays the following output:
  //       aaaaabbbcccccccdd.Substring(5, 3) = bbb
  

  Module Example
     Public Sub Main()
        Dim s As String = "aaaaabbbcccccccdd"
        Dim charRange As Char = "b"c
        Dim startIndex As Integer = s.Indexof(charRange)
        Dim endIndex As Integer = s.LastIndexOf(charRange)
        Dim length = endIndex - startIndex + 1
        Console.WriteLine("{0}.Substring({1}, {2}) = {3}",
                          s, startIndex, length, 
                          s.Substring(startIndex, length))
     End Sub
  End Module
  ' The example displays the following output:
  '     aaaaabbbcccccccdd.Substring(5, 3) = bbb
  

• Wenn Sie nach mehreren Zeichen gesucht haben, die das Ende der Teilzeichenfolge markieren sollen, entsprichtlengthendIndex + endMatchLength - der startIndex Parameter , wobei endIndex der Rückgabewert der IndexOf Oder-Methode LastIndexOf ist und endMatchLength die Länge der Zeichensequenz, die das Ende der Teilzeichenfolge markiert. Im folgenden Beispiel wird ein Textblock extrahiert, der ein XML-Element <definition> enthält.

  String s = "<term>extant<definition>still in existence</definition></term>";
  String searchString = "<definition>";
  int startIndex = s.IndexOf(searchString);
  searchString = "</" + searchString.Substring(1);
  int endIndex = s.IndexOf(searchString);
  String substring = s.Substring(startIndex, endIndex + searchString.Length - startIndex);
  Console.WriteLine("Original string: {0}", s);
  Console.WriteLine("Substring;       {0}", substring); 
  
  // The example displays the following output:
  //     Original string: <term>extant<definition>still in existence</definition></term>
  //     Substring;       <definition>still in existence</definition>
  

  let s = "<term>extant<definition>still in existence</definition></term>"
  let searchString = "<definition>"
  let startIndex = s.IndexOf(searchString)
  let searchString = "</" + searchString.Substring 1
  let endIndex = s.IndexOf searchString
  let substring = s.Substring(startIndex, endIndex + searchString.Length - startIndex)
  printfn $"Original string: {s}"
  printfn $"Substring;       {substring}"
  
  // The example displays the following output:
  //     Original string: <term>extant<definition>still in existence</definition></term>
  //     Substring;       <definition>still in existence</definition>
  

  Module Example
     Public Sub Main()
        Dim s As String = "<term>extant<definition>still in existence</definition></term>"
        Dim searchString As String = "<definition>"
        Dim startindex As Integer = s.IndexOf(searchString)
        searchString = "</" + searchString.Substring(1)
        Dim endIndex As Integer = s.IndexOf(searchString)
        Dim substring As String = s.Substring(startIndex, endIndex + searchString.Length - StartIndex)
        Console.WriteLine("Original string: {0}", s)
        Console.WriteLine("Substring;       {0}", substring) 
     End Sub
  End Module
  ' The example displays the following output:
  '   Original string: <term>extant<definition>still in existence</definition></term>
  '   Substring;       <definition>still in existence</definition>
  

• Wenn das Zeichen oder die Zeichenfolge nicht am Ende der Teilzeichenfolge enthalten ist, entsprichtlengthendIndex - der startIndex Parameter dem endIndex Rückgabewert der IndexOf Oder-Methode.LastIndexOf

Wenn startIndex gleich Null ist und length der Länge der aktuellen Zeichenfolge entspricht, gibt die Methode die ursprüngliche Zeichenfolge unverändert zurück.

Weitere Informationen

• Remove(Int32, Int32)
• Replace(Char, Char)
• Trim(Char[])