Regex.Match Metode

Referensi

Definisi

Ruang nama:: System.Text.RegularExpressions

Rakitan:: System.Text.RegularExpressions.dll

Rakitan:: System.dll

Rakitan:: netstandard.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Mencari string input untuk substring yang cocok dengan pola ekspresi reguler dan mengembalikan kemunculan pertama sebagai objek tunggal Match .

Overload

Match(String, String, RegexOptions)	Mencari string input untuk kemunculan pertama ekspresi reguler yang ditentukan, menggunakan opsi pencocokan yang ditentukan.
Match(String)	Mencari string input yang ditentukan untuk kemunculan pertama ekspresi reguler yang ditentukan dalam Regex konstruktor.
Match(String, Int32)	Mencari string input untuk kemunculan pertama ekspresi reguler, dimulai pada posisi awal yang ditentukan dalam string.
Match(String, String)	Mencari string input yang ditentukan untuk kemunculan pertama ekspresi reguler yang ditentukan.
Match(String, Int32, Int32)	Mencari string input untuk kemunculan pertama ekspresi reguler, dimulai pada posisi awal yang ditentukan dan hanya mencari jumlah karakter yang ditentukan.
Match(String, String, RegexOptions, TimeSpan)	Mencari string input untuk kemunculan pertama ekspresi reguler yang ditentukan, menggunakan opsi pencocokan yang ditentukan dan interval waktu habis.

Match(String, String, RegexOptions)

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Mencari string input untuk kemunculan pertama ekspresi reguler yang ditentukan, menggunakan opsi pencocokan yang ditentukan.

public:
 static System::Text::RegularExpressions::Match ^ Match(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options);

public static System.Text.RegularExpressions.Match Match (string input, string pattern, System.Text.RegularExpressions.RegexOptions options);

static member Match : string * string * System.Text.RegularExpressions.RegexOptions -> System.Text.RegularExpressions.Match

Public Shared Function Match (input As String, pattern As String, options As RegexOptions) As Match

Parameter

input: String

String untuk mencari kecocokan.

pattern: String

Pola regex yang cocok.

options: RegexOptions

Kombinasi bitwise dari nilai enumerasi yang menyediakan opsi untuk pencocokan.

Mengembalikan

Match

Objek yang berisi informasi tentang kecocokan.

Pengecualian

ArgumentException

Terjadi kesalahan penguraian ekspresi reguler.

ArgumentNullException

input atau pattern adalah null.

ArgumentOutOfRangeException

options bukan kombinasi RegexOptions nilai bitwise yang valid.

RegexMatchTimeoutException

Waktu habis terjadi. Untuk informasi selengkapnya tentang waktu habis, lihat bagian Keterangan.

Contoh

Contoh berikut mendefinisikan ekspresi reguler yang cocok dengan kata-kata yang dimulai dengan huruf "a". Ini menggunakan RegexOptions.IgnoreCase opsi untuk memastikan bahwa ekspresi reguler menemukan kata-kata yang dimulai dengan huruf besar "a" dan huruf kecil "a".

using System;
using System.Text.RegularExpressions;

namespace Examples
{
    public class Example2
    {
        public static void Main()
        {
            string pattern = @"\ba\w*\b";
            string input = "An extraordinary day dawns with each new day.";
            Match m = Regex.Match(input, pattern, RegexOptions.IgnoreCase);
            if (m.Success)
                Console.WriteLine("Found '{0}' at position {1}.", m.Value, m.Index);
        }
    }
}

// The example displays the following output:
//        Found 'An' at position 0.

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim pattern As String = "\ba\w*\b"
      Dim input As String = "An extraordinary day dawns with each new day."
      Dim m As Match = Regex.Match(input, pattern, RegexOptions.IgnoreCase)
      If m.Success Then
         Console.WriteLine("Found '{0}' at position {1}.", m.Value, m.Index)
      End If
   End Sub
End Module
' The example displays the following output:
'       Found 'An' at position 0.

Pola regex \ba\w*\b ditafsirkan seperti yang ditunjukkan pada tabel berikut.

Pola	Deskripsi
`\b`	Memulai pencocokan dalam batas kata.
`a`	Cocok dengan karakter "a".
`\w*`	Cocokkan nol, satu, atau beberapa karakter kata.
`\b`	Mengakhiri pencocokan dalam batas kata.

Keterangan

Metode mengembalikan Match(String, String, RegexOptions) substring pertama yang cocok dengan pola ekspresi reguler dalam string input. Untuk informasi tentang elemen bahasa yang digunakan untuk membangun pola ekspresi reguler, lihat Bahasa Ekspresi Reguler - Referensi Cepat.

Metode statis Match(String, String, RegexOptions) setara dengan membangun Regex objek dengan Regex(String, RegexOptions) konstruktor dan memanggil metode instans Match(String) .

Parameter pattern terdiri dari elemen bahasa ekspresi reguler yang secara simbolis menggambarkan string yang cocok. Untuk informasi selengkapnya tentang ekspresi reguler, lihat Ekspresi Reguler .NET dan Bahasa Ekspresi Reguler - Referensi Cepat.

Anda dapat menentukan apakah pola ekspresi reguler telah ditemukan dalam string input dengan memeriksa nilai properti objek Success yang dikembalikanMatch. Jika kecocokan ditemukan, properti objek Value yang dikembalikan Match berisi substring dari input yang cocok dengan pola ekspresi reguler. Jika tidak ada kecocokan yang ditemukan, nilainya adalah String.Empty.

Metode ini mengembalikan substring pertama yang ditemukan yang input cocok dengan pola ekspresi reguler. Anda dapat mengambil kecocokan berikutnya dengan berulang kali memanggil metode objek NextMatch yang dikembalikanMatch. Anda juga dapat mengambil semua kecocokan dalam satu panggilan metode dengan memanggil Regex.Matches(String, String, RegexOptions) metode .

Pengecualian RegexMatchTimeoutException dilemparkan jika waktu eksekusi operasi pencocokan melebihi interval waktu habis yang ditentukan untuk domain aplikasi tempat metode dipanggil. Jika tidak ada waktu habis yang ditentukan dalam properti domain aplikasi, atau jika nilai waktu habis adalah Regex.InfiniteMatchTimeout, tidak ada pengecualian yang dilemparkan.

Catatan Bagi Pemanggil

Metode ini kehabisan waktu setelah interval yang sama dengan nilai batas waktu default domain aplikasi tempatnya dipanggil. Jika nilai waktu habis belum ditentukan untuk domain aplikasi, nilai InfiniteMatchTimeout, yang mencegah waktu habis metode digunakan. Metode statis yang direkomendasikan untuk mengambil kecocokan pola adalah Match(String, String), yang memungkinkan Anda mengatur interval waktu habis.

Lihat juga

Berlaku untuk

Match(String)

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Mencari string input yang ditentukan untuk kemunculan pertama ekspresi reguler yang ditentukan dalam Regex konstruktor.

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input);

public System.Text.RegularExpressions.Match Match (string input);

member this.Match : string -> System.Text.RegularExpressions.Match

Public Function Match (input As String) As Match

Parameter

input: String

String untuk mencari kecocokan.

Mengembalikan

Match

Objek yang berisi informasi tentang kecocokan.

Pengecualian

ArgumentNullException

inputadalah null.

RegexMatchTimeoutException

Waktu habis terjadi. Untuk informasi selengkapnya tentang waktu habis, lihat bagian Keterangan.

Contoh

Contoh berikut menemukan kecocokan pola ekspresi reguler dalam string, lalu mencantumkan grup, pengambilan, dan posisi pengambilan yang cocok.

#using <System.dll>

using namespace System;
using namespace System::Text::RegularExpressions;
void main()
{
   
   String^ text = "One car red car blue car";
   String^ pat = "(\\w+)\\s+(car)";
   
   // Compile the regular expression.
   Regex^ r = gcnew Regex( pat,RegexOptions::IgnoreCase );
   
   // Match the regular expression pattern against a text string.
   Match^ m = r->Match(text);
   int matchCount = 0;
   while ( m->Success )
   {
      Console::WriteLine( "Match{0}", ++matchCount );
      for ( int i = 1; i <= 2; i++ )
      {
         Group^ g = m->Groups[ i ];
         Console::WriteLine( "Group{0}='{1}'", i, g );
         CaptureCollection^ cc = g->Captures;
         for ( int j = 0; j < cc->Count; j++ )
         {
            Capture^ c = cc[ j ];
            System::Console::WriteLine( "Capture{0}='{1}', Position={2}", j, c, c->Index );
         }
      }
      m = m->NextMatch();
   }
}  
// This example displays the following output:
//       Match1
//       Group1='One'
//       Capture0='One', Position=0
//       Group2='car'
//       Capture0='car', Position=4
//       Match2
//       Group1='red'
//       Capture0='red', Position=8
//       Group2='car'
//       Capture0='car', Position=12
//       Match3
//       Group1='blue'
//       Capture0='blue', Position=16
//       Group2='car'
//       Capture0='car', Position=21

using System;
using System.Text.RegularExpressions;

class Example
{
   static void Main()
   {
      string text = "One car red car blue car";
      string pat = @"(\w+)\s+(car)";

      // Instantiate the regular expression object.
      Regex r = new Regex(pat, RegexOptions.IgnoreCase);

      // Match the regular expression pattern against a text string.
      Match m = r.Match(text);
      int matchCount = 0;
      while (m.Success)
      {
         Console.WriteLine("Match"+ (++matchCount));
         for (int i = 1; i <= 2; i++)
         {
            Group g = m.Groups[i];
            Console.WriteLine("Group"+i+"='" + g + "'");
            CaptureCollection cc = g.Captures;
            for (int j = 0; j < cc.Count; j++)
            {
               Capture c = cc[j];
               System.Console.WriteLine("Capture"+j+"='" + c + "', Position="+c.Index);
            }
         }
         m = m.NextMatch();
      }
   }
}
// This example displays the following output:
//       Match1
//       Group1='One'
//       Capture0='One', Position=0
//       Group2='car'
//       Capture0='car', Position=4
//       Match2
//       Group1='red'
//       Capture0='red', Position=8
//       Group2='car'
//       Capture0='car', Position=12
//       Match3
//       Group1='blue'
//       Capture0='blue', Position=16
//       Group2='car'
//       Capture0='car', Position=21

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim text As String = "One car red car blue car"
      Dim pattern As String = "(\w+)\s+(car)"

      ' Instantiate the regular expression object.
      Dim r As Regex = new Regex(pattern, RegexOptions.IgnoreCase)

      ' Match the regular expression pattern against a text string.
      Dim m As Match = r.Match(text)
      Dim matchcount as Integer = 0
      Do While m.Success
         matchCount += 1
         Console.WriteLine("Match" & (matchCount))
         Dim i As Integer
         For i = 1 to 2
            Dim g as Group = m.Groups(i)
            Console.WriteLine("Group" & i & "='" & g.ToString() & "'")
            Dim cc As CaptureCollection = g.Captures
            Dim j As Integer 
            For j = 0 to cc.Count - 1
              Dim c As Capture = cc(j)
               Console.WriteLine("Capture" & j & "='" & c.ToString() _
                  & "', Position=" & c.Index)
            Next 
         Next 
         m = m.NextMatch()
      Loop
   End Sub
End Module
' This example displays the following output:
'       Match1
'       Group1='One'
'       Capture0='One', Position=0
'       Group2='car'
'       Capture0='car', Position=4
'       Match2
'       Group1='red'
'       Capture0='red', Position=8
'       Group2='car'
'       Capture0='car', Position=12
'       Match3
'       Group1='blue'
'       Capture0='blue', Position=16
'       Group2='car'
'       Capture0='car', Position=21

Pola (\w+)\s+(car) ekspresi reguler cocok dengan kemunculan kata "mobil" bersama dengan kata yang mendahuluinya. Ini ditafsirkan seperti yang ditunjukkan dalam tabel berikut.

Pola	Deskripsi
`(\w+)`	Cocokkan satu atau lebih karakter kata. Ini adalah grup pengambilan pertama.
`\s+`	Cocokkan satu atau beberapa karakter white space.
(Mobil)	Cocokkan string harfiah "mobil". Ini adalah grup pengambilan kedua.

Keterangan

Metode mengembalikan Match(String) substring pertama yang cocok dengan pola ekspresi reguler dalam string input. Untuk informasi tentang elemen bahasa yang digunakan untuk membangun pola ekspresi reguler, lihat Bahasa Ekspresi Reguler - Referensi Cepat.

Metode ini mengembalikan substring pertama yang input cocok dengan pola ekspresi reguler. Anda dapat mengambil kecocokan berikutnya dengan berulang kali memanggil metode objek Match.NextMatch yang dikembalikanMatch. Anda juga dapat mengambil semua kecocokan dalam satu panggilan metode dengan memanggil Regex.Matches(String) metode .

Pengecualian RegexMatchTimeoutException dilemparkan jika waktu eksekusi operasi pencocokan melebihi interval waktu habis yang ditentukan oleh Regex.Regex(String, RegexOptions, TimeSpan) konstruktor. Jika Anda tidak mengatur interval waktu habis saat Anda memanggil konstruktor, pengecualian akan dilemparkan jika operasi melebihi nilai waktu habis yang ditetapkan untuk domain aplikasi tempat Regex objek dibuat. Jika tidak ada waktu habis yang ditentukan dalam Regex panggilan konstruktor atau di properti domain aplikasi, atau jika nilai waktu habis adalah Regex.InfiniteMatchTimeout, tidak ada pengecualian yang dilemparkan.

Lihat juga

Berlaku untuk

Match(String, Int32)

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Mencari string input untuk kemunculan pertama ekspresi reguler, dimulai pada posisi awal yang ditentukan dalam string.

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input, int startat);

public System.Text.RegularExpressions.Match Match (string input, int startat);

member this.Match : string * int -> System.Text.RegularExpressions.Match

Public Function Match (input As String, startat As Integer) As Match

Parameter

input: String

String untuk mencari kecocokan.

startat: Int32

Posisi karakter berbasis nol untuk memulai pencarian.

Mengembalikan

Match

Objek yang berisi informasi tentang kecocokan.

Pengecualian

ArgumentNullException

inputadalah null.

ArgumentOutOfRangeException

startat kurang dari nol atau lebih besar dari inputpanjang .

RegexMatchTimeoutException

Waktu habis terjadi. Untuk informasi selengkapnya tentang waktu habis, lihat bagian Keterangan.

Keterangan

Untuk informasi selengkapnya tentang API ini, lihat Keterangan API Tambahan untuk Regex.Match.

Lihat juga

Berlaku untuk

Match(String, String)

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Mencari string input yang ditentukan untuk kemunculan pertama ekspresi reguler yang ditentukan.

public:
 static System::Text::RegularExpressions::Match ^ Match(System::String ^ input, System::String ^ pattern);

public static System.Text.RegularExpressions.Match Match (string input, string pattern);

static member Match : string * string -> System.Text.RegularExpressions.Match

Public Shared Function Match (input As String, pattern As String) As Match

Parameter

input: String

String untuk mencari kecocokan.

pattern: String

Pola regex yang cocok.

Mengembalikan

Match

Objek yang berisi informasi tentang kecocokan.

Pengecualian

ArgumentException

Terjadi kesalahan penguraian ekspresi reguler.

ArgumentNullException

input atau pattern adalah null.

RegexMatchTimeoutException

Waktu habis terjadi. Untuk informasi selengkapnya tentang waktu habis, lihat bagian Keterangan.

Contoh

Contoh berikut memanggil Match(String, String) metode untuk menemukan kata pertama yang berisi setidaknya satu z karakter, lalu memanggil Match.NextMatch metode untuk menemukan kecocokan tambahan.

using System;
using System.Text.RegularExpressions;

namespace Examples
{
    public class Example
    {
        public static void Main()
        {
            string input = "ablaze beagle choral dozen elementary fanatic " +
                           "glaze hunger inept jazz kitchen lemon minus " +
                           "night optical pizza quiz restoration stamina " +
                           "train unrest vertical whiz xray yellow zealous";
            string pattern = @"\b\w*z+\w*\b";
            Match m = Regex.Match(input, pattern);
            while (m.Success)
            {
                Console.WriteLine("'{0}' found at position {1}", m.Value, m.Index);
                m = m.NextMatch();
            }
        }
    }
}

// The example displays the following output:
//    'ablaze' found at position 0
//    'dozen' found at position 21
//    'glaze' found at position 46
//    'jazz' found at position 65
//    'pizza' found at position 104
//    'quiz' found at position 110
//    'whiz' found at position 157
//    'zealous' found at position 174

Imports System.Text.RegularExpressions

Module Example
   Public Sub Main()
      Dim input As String = "ablaze beagle choral dozen elementary fanatic " +
                            "glaze hunger inept jazz kitchen lemon minus " +
                            "night optical pizza quiz restoration stamina " +
                            "train unrest vertical whiz xray yellow zealous"
      Dim pattern As String = "\b\w*z+\w*\b"
      Dim m As Match = Regex.Match(input, pattern)
      Do While m.Success 
         Console.WriteLine("'{0}' found at position {1}", m.Value, m.Index)
         m = m.NextMatch()
      Loop                      
   End Sub
End Module
' The example displays the following output:
    'ablaze' found at position 0
    'dozen' found at position 21
    'glaze' found at position 46
    'jazz' found at position 65
    'pizza' found at position 104
    'quiz' found at position 110
    'whiz' found at position 157
    'zealous' found at position 174

Pola regex \b\w*z+\w*\b ditafsirkan seperti yang ditunjukkan pada tabel berikut.

Pola	Deskripsi
`\b`	Memulai pencocokan dalam batas kata.
`\w*`	Cocokkan nol, satu, atau beberapa karakter kata.
`z+`	Cocokkan satu atau beberapa kemunculan `z` karakter.
`\w*`	Cocokkan nol, satu, atau beberapa karakter kata.
`\b`	Mengakhiri pencocokan dalam batas kata.

Keterangan

Metode mengembalikan Match(String, String) substring pertama yang cocok dengan pola ekspresi reguler dalam string input. Untuk informasi tentang elemen bahasa yang digunakan untuk membangun pola ekspresi reguler, lihat Bahasa Ekspresi Reguler - Referensi Cepat.

Metode statis Match(String, String) setara dengan membangun Regex objek dengan pola ekspresi reguler yang ditentukan dan memanggil metode instans Match(String) . Dalam hal ini, mesin ekspresi reguler menyimpan pola ekspresi reguler.

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Match(String, Int32, Int32)

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Mencari string input untuk kemunculan pertama ekspresi reguler, dimulai pada posisi awal yang ditentukan dan hanya mencari jumlah karakter yang ditentukan.

public:
 System::Text::RegularExpressions::Match ^ Match(System::String ^ input, int beginning, int length);

public System.Text.RegularExpressions.Match Match (string input, int beginning, int length);

member this.Match : string * int * int -> System.Text.RegularExpressions.Match

Public Function Match (input As String, beginning As Integer, length As Integer) As Match

Parameter

input: String

String untuk mencari kecocokan.

beginning: Int32

Posisi karakter berbasis nol dalam string input yang menentukan posisi paling kiri yang akan dicari.

length: Int32

Jumlah karakter dalam substring yang akan disertakan dalam pencarian.

Mengembalikan

Match

Objek yang berisi informasi tentang kecocokan.

Pengecualian

ArgumentNullException

inputadalah null.

ArgumentOutOfRangeException

beginning kurang dari nol atau lebih besar dari inputpanjang .

-atau-

length kurang dari nol atau lebih besar dari inputpanjang .

-atau-

beginning+length-1 mengidentifikasi posisi yang berada di luar rentang input.

RegexMatchTimeoutException

Waktu habis terjadi. Untuk informasi selengkapnya tentang waktu habis, lihat bagian Keterangan.

Keterangan

Metode mengembalikan Match(String, Int32, Int32) substring pertama yang cocok dengan pola ekspresi reguler dalam sebagian string input. Untuk informasi tentang elemen bahasa yang digunakan untuk membangun pola ekspresi reguler, lihat Bahasa Ekspresi Reguler - Referensi Cepat.

Pola ekspresi reguler tempat Match(String, Int32, Int32) pencarian metode ditentukan oleh panggilan ke salah Regex satu konstruktor kelas. Untuk informasi selengkapnya tentang elemen yang dapat membentuk pola ekspresi reguler, lihat Bahasa Ekspresi Reguler - Referensi Cepat.

Metode Match(String, Int32, Int32) ini mencari bagian yang input ditentukan oleh beginning parameter dan length untuk pola ekspresi reguler. beginning selalu menentukan indeks karakter paling kiri untuk disertakan dalam pencarian, dan length menentukan jumlah karakter maksimum yang akan dicari. Bersama-sama, mereka menentukan rentang pencarian. Perilakunya persis seolah-olah input itu secara input.Substring(beginning, length)efektif , kecuali bahwa indeks kecocokan apa pun dihitung relatif terhadap awal input. Ini berarti bahwa setiap jangkar atau pernyataan lebar nol di awal atau akhir pola bertingkah seolah-olah tidak input ada di luar rentang ini. Misalnya jangkar , , dan \A akan terpenuhi di beginning dan $ dan \z akan puas di beginning + length - 1. \G^

Jika pencarian berlanjut dari kiri ke kanan (default), mesin ekspresi reguler mencari dari karakter pada indeks beginning ke karakter pada indeks beginning + length - 1. Jika mesin ekspresi reguler dibuat dengan menggunakan RegexOptions.RightToLeft opsi sehingga pencarian berlanjut dari kanan ke kiri, mesin ekspresi reguler mencari dari karakter pada indeks beginning + length - 1 ke karakter pada indeks beginning.

Metode ini mengembalikan kecocokan pertama yang ditemukan dalam rentang ini. Anda dapat mengambil kecocokan berikutnya dengan berulang kali memanggil metode objek Match.NextMatch yang dikembalikanMatch.

Pengecualian RegexMatchTimeoutException dilemparkan jika waktu eksekusi operasi pencocokan melebihi interval waktu habis yang ditentukan oleh Regex.Regex(String, RegexOptions, TimeSpan) konstruktor. Jika Anda tidak menetapkan nilai waktu habis saat Anda memanggil konstruktor, pengecualian akan dibuang jika operasi melebihi nilai waktu habis yang ditetapkan untuk domain aplikasi tempat Regex objek dibuat. Jika tidak ada waktu habis yang ditentukan dalam Regex panggilan konstruktor atau di properti domain aplikasi, atau jika nilai waktu habis adalah Regex.InfiniteMatchTimeout, tidak ada pengecualian yang dilemparkan.

Lihat juga

Berlaku untuk

Match(String, String, RegexOptions, TimeSpan)

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Sumber:: Regex.Match.cs

Mencari string input untuk kemunculan pertama ekspresi reguler yang ditentukan, menggunakan opsi pencocokan yang ditentukan dan interval waktu habis.

public:
 static System::Text::RegularExpressions::Match ^ Match(System::String ^ input, System::String ^ pattern, System::Text::RegularExpressions::RegexOptions options, TimeSpan matchTimeout);

public static System.Text.RegularExpressions.Match Match (string input, string pattern, System.Text.RegularExpressions.RegexOptions options, TimeSpan matchTimeout);

static member Match : string * string * System.Text.RegularExpressions.RegexOptions * TimeSpan -> System.Text.RegularExpressions.Match

Public Shared Function Match (input As String, pattern As String, options As RegexOptions, matchTimeout As TimeSpan) As Match

Parameter

input: String

String untuk mencari kecocokan.

pattern: String

Pola regex yang cocok.

options: RegexOptions

Kombinasi bitwise dari nilai enumerasi yang menyediakan opsi untuk pencocokan.

matchTimeout: TimeSpan

Interval waktu habis, atau InfiniteMatchTimeout untuk menunjukkan bahwa metode tidak boleh kehabisan waktu.

Mengembalikan

Match

Objek yang berisi informasi tentang kecocokan.

Pengecualian

ArgumentException

Terjadi kesalahan penguraian ekspresi reguler.

ArgumentNullException

input atau pattern adalah null.

ArgumentOutOfRangeException

options bukan kombinasi RegexOptions nilai bitwise yang valid.

-atau-

matchTimeout negatif, nol, atau lebih besar dari sekitar 24 hari.

RegexMatchTimeoutException

Waktu habis terjadi. Untuk informasi selengkapnya tentang waktu habis, lihat bagian Keterangan.

Keterangan

Metode mengembalikan Match(String, String, RegexOptions, TimeSpan) substring pertama yang cocok dengan pola ekspresi reguler dalam string input. Untuk informasi tentang elemen bahasa yang digunakan untuk membangun pola ekspresi reguler, lihat Bahasa Ekspresi Reguler - Referensi Cepat.

Metode statis Match(String, String, RegexOptions, TimeSpan) setara dengan membangun Regex objek dengan Regex(String, RegexOptions, TimeSpan) konstruktor dan memanggil metode instans Match(String) .

Parameter matchTimeout menentukan berapa lama metode pencocokan pola harus mencoba menemukan kecocokan sebelum waktu habis. Mengatur interval waktu habis mencegah ekspresi reguler yang mengandalkan backtracking yang berlebihan muncul untuk berhenti merespons saat memproses input yang berisi kecocokan dekat. Untuk informasi selengkapnya, lihat Praktik Terbaik untuk Ekspresi Reguler dan Backtracking. Jika tidak ada kecocokan yang ditemukan dalam interval waktu tersebut, metode akan memberikan RegexMatchTimeoutException pengecualian. matchTimeout mengambil alih nilai batas waktu default yang ditentukan untuk domain aplikasi tempat metode dijalankan.

Catatan Bagi Pemanggil

Kami menyarankan agar Anda mengatur parameter ke matchTimeout nilai yang sesuai, seperti dua detik. Jika Anda menonaktifkan waktu habis dengan menentukan InfiniteMatchTimeout, mesin ekspresi reguler menawarkan performa yang sedikit lebih baik. Namun, Anda harus menonaktifkan waktu habis hanya dalam kondisi berikut:

Ketika input yang diproses oleh ekspresi reguler berasal dari sumber yang diketahui dan tepercaya atau terdiri dari teks statis. Ini mengecualikan teks yang telah dimasukkan secara dinamis oleh pengguna.
Ketika pola ekspresi reguler telah diuji secara menyeluruh untuk memastikan bahwa pola tersebut secara efisien menangani kecocokan, non-kecocokan, dan hampir kecocokan.
Ketika pola ekspresi reguler tidak berisi elemen bahasa yang diketahui menyebabkan backtracking yang berlebihan saat memproses kecocokan dekat.

Lihat juga

Bahasa Regex - Referensi Singkat

Berlaku untuk

Regex.Match Metode

Definisi

Overload

Match(String, String, RegexOptions)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Match(String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Match(String, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Match(String, String)

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Match(String, Int32, Int32)

Parameter

Mengembalikan

Pengecualian

Keterangan

Lihat juga

Berlaku untuk

Match(String, String, RegexOptions, TimeSpan)

Parameter

Mengembalikan

Pengecualian

Keterangan

Catatan Bagi Pemanggil

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: