Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Regex.IsMatch-Methode: (String)

 

Veröffentlicht: Oktober 2016

Gibt an, ob der im Regex-Konstruktor angegebene reguläre Ausdruck eine Übereinstimmung in einer angegebenen Eingabezeichenfolge findet.

Namespace:   System.Text.RegularExpressions
Assembly:  System (in System.dll)

public bool IsMatch(
	string input
)

Parameter

input
Type: System.String

Die nach einer Übereinstimmung zu durchsuchende Zeichenfolge.

Rückgabewert

Type: System.Boolean

true, wenn der reguläre Ausdruck eine Übereinstimmung findet, andernfalls false.

Exception Condition
ArgumentNullException

input ist null.

RegexMatchTimeoutException

Es ist ein Timeout aufgetreten. Weitere Informationen zu Timeouts finden Sie im Abschnitt „Hinweise“.

Die IsMatch Methode wird normalerweise verwendet, um eine Zeichenfolge zu überprüfen oder um sicherzustellen, dass eine Zeichenfolge mit einem bestimmten Muster entspricht, ohne diese Zeichenfolge für eine nachfolgende Änderung abzurufen. Wenn Sie bestimmen möchten, ob eine oder mehrere Zeichenfolgen Muster eines regulären Ausdrucks übereinstimmen, und klicken Sie dann für die Bearbeitung von nachfolgenden Aufruf Abrufen der Match oder Matches Methode.

Die RegexMatchTimeoutException Ausnahme wird ausgelöst, wenn die Ausführungszeit den entsprechenden Vorgang des angegebenen Timeoutintervalls überschreitet die Regex.Regex(String, RegexOptions, TimeSpan) Konstruktor. Wenn Sie ein Timeoutintervall nicht festlegen, wenn Sie den Konstruktor aufrufen, wird die Ausnahme ausgelöst, wenn der Vorgang alle für die Anwendungsdomäne eingerichtet, in dem Timeoutwert überschreitet die Regex Objekt erstellt wird. Wenn kein Timeout, in definiert ist der Regex Konstruktoraufruf oder in Eigenschaften der Anwendungsdomäne, oder wenn der Timeoutwert ist Regex.InfiniteMatchTimeout, wird keine Ausnahme ausgelöst.

Das folgende Beispiel veranschaulicht die Verwendung der IsMatch(String) Methode, um zu bestimmen, ob eine Zeichenfolge eine gültige Teilenummer handelt. Der reguläre Ausdruck wird davon ausgegangen, dass die Teilenummer ein bestimmtes Format aufweist, das besteht aus drei Gruppen von Zeichen, die durch Bindestriche getrennt sind. Der erste Satz, der vier Zeichen enthält, muss aus einem alphanumerischen Zeichen, gefolgt von zwei Ziffern gefolgt von einem alphanumerischen Zeichen bestehen. Die zweite Gruppe, die aus drei Zeichen besteht, muss numerisch sein. Der dritte Satz, der aus vier Zeichen besteht, muss drei numerische Zeichen, gefolgt von einem alphanumerischen Zeichen haben.

using System;
using System.Text.RegularExpressions;

public class Example
{
   public static void Main()
   {
      string[] partNumbers= { "1298-673-4192", "A08Z-931-468A", 
                              "_A90-123-129X", "12345-KKA-1230", 
                              "0919-2893-1256" };
      Regex rgx = new Regex(@"^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$");
      foreach (string partNumber in partNumbers)
         Console.WriteLine("{0} {1} a valid part number.", 
                           partNumber, 
                           rgx.IsMatch(partNumber) ? "is" : "is not");
   }
}
// The example displays the following output:
//       1298-673-4192 is a valid part number.
//       A08Z-931-468A is a valid part number.
//       _A90-123-129X is not a valid part number.
//       12345-KKA-1230 is not a valid part number.
//       0919-2893-1256 is not a valid part number.

Das Muster des regulären Ausdrucks lautet:

^[a-zA-Z0-9]\d{2}[a-zA-Z0-9](-\d{3}){2}[A-Za-z0-9]$

Die folgende Tabelle zeigt, wie das Muster eines regulären Ausdrucks interpretiert wird.

Muster

Beschreibung

^

Beginnt den Vergleich am Anfang der Zeile.

[a-zA-Z0-9]

Ein einzelnes alphabetisches Zeichen entsprechen (a über z oder A über Z) oder ein numerisches Zeichen.

\d{2}

Übereinstimmung mit zwei numerischen Zeichen.

[a-zA-Z0-9]

Ein einzelnes alphabetisches Zeichen entsprechen (a über z oder A über Z) oder ein numerisches Zeichen.

-

Entsprechung für einen Bindestrich finden.

\d{3}

Übereinstimmung mit genau drei numerischen Zeichen.

(-\d{3}){2}

Suchen Sie einen Bindestrich gefolgt von drei Ziffern und entsprechen Sie zwei Vorkommen dieses Muster.

[a-zA-Z0-9]

Ein einzelnes alphabetisches Zeichen entsprechen (a über z oder A über Z) oder ein numerisches Zeichen.

$

Ende des Abgleichs am Ende der Zeile.

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: