String.Contains Metode
Definisi
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.
Overload
Contains(String, StringComparison) |
Mengembalikan nilai yang menunjukkan apakah string tertentu terjadi dalam string ini, menggunakan aturan perbandingan yang ditentukan. |
Contains(Char, StringComparison) |
Mengembalikan nilai yang menunjukkan apakah karakter tertentu terjadi dalam string ini, menggunakan aturan perbandingan yang ditentukan. |
Contains(String) |
Mengembalikan nilai yang menunjukkan apakah substring tertentu terjadi dalam string ini. |
Contains(Char) |
Mengembalikan nilai yang menunjukkan apakah karakter tertentu terjadi dalam string ini. |
Contains(String, StringComparison)
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
Mengembalikan nilai yang menunjukkan apakah string tertentu terjadi dalam string ini, menggunakan aturan perbandingan yang ditentukan.
public:
bool Contains(System::String ^ value, StringComparison comparisonType);
public bool Contains (string value, StringComparison comparisonType);
member this.Contains : string * StringComparison -> bool
Public Function Contains (value As String, comparisonType As StringComparison) As Boolean
Parameter
- value
- String
String yang akan dicari.
- comparisonType
- StringComparison
Salah satu nilai enumerasi yang menentukan aturan yang akan digunakan dalam perbandingan.
Mengembalikan
true
value
jika parameter terjadi dalam string ini, atau jika value
adalah string kosong (""); jika tidak, false
.
Berlaku untuk
Contains(Char, StringComparison)
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
Mengembalikan nilai yang menunjukkan apakah karakter tertentu terjadi dalam string ini, menggunakan aturan perbandingan yang ditentukan.
public:
bool Contains(char value, StringComparison comparisonType);
public bool Contains (char value, StringComparison comparisonType);
member this.Contains : char * StringComparison -> bool
Public Function Contains (value As Char, comparisonType As StringComparison) As Boolean
Parameter
- value
- Char
Karakter yang akan dicari.
- comparisonType
- StringComparison
Salah satu nilai enumerasi yang menentukan aturan yang akan digunakan dalam perbandingan.
Mengembalikan
true
value
jika parameter terjadi dalam string ini; jika tidak, false
.
Berlaku untuk
Contains(String)
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
Mengembalikan nilai yang menunjukkan apakah substring tertentu terjadi dalam string ini.
public:
bool Contains(System::String ^ value);
public bool Contains (string value);
member this.Contains : string -> bool
Public Function Contains (value As String) As Boolean
Parameter
- value
- String
String yang akan dicari.
Mengembalikan
true
value
jika parameter terjadi dalam string ini, atau jika value
adalah string kosong (""); jika tidak, false
.
Pengecualian
value
adalah null
.
Contoh
Contoh berikut menentukan apakah string "fox" adalah substring dari kutipan yang familier. Jika "fox" ditemukan dalam string, itu juga menampilkan posisi awalnya.
using namespace System;
int main()
{
String^ s1 = "The quick brown fox jumps over the lazy dog";
String^ s2 = "fox";
bool b = s1->Contains( s2 );
Console::WriteLine( "Is the string, s2, in the string, s1?: {0}", b );
if (b) {
int index = s1->IndexOf(s2);
if (index >= 0)
Console::WriteLine("'{0} begins at character position {1}",
s2, index + 1);
}
}
// This example displays the following output:
// 'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
// 'fox begins at character position 17
string s1 = "The quick brown fox jumps over the lazy dog";
string s2 = "fox";
bool b = s1.Contains(s2);
Console.WriteLine("'{0}' is in the string '{1}': {2}",
s2, s1, b);
if (b) {
int index = s1.IndexOf(s2);
if (index >= 0)
Console.WriteLine("'{0} begins at character position {1}",
s2, index + 1);
}
// This example displays the following output:
// 'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
// 'fox begins at character position 17
let s1 = "The quick brown fox jumps over the lazy dog"
let s2 = "fox"
let b = s1.Contains s2
printfn $"'{s2}' is in the string '{s1}': {b}"
if b then
let index = s1.IndexOf s2
if index >= 0 then
printfn $"'{s2} begins at character position {index + 1}"
// This example displays the following output:
// 'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
// 'fox begins at character position 17
Class Example
Public Shared Sub Main()
Dim s1 As String = "The quick brown fox jumps over the lazy dog"
Dim s2 As String = "fox"
Dim b As Boolean = s1.Contains(s2)
Console.WriteLine("'{0}' is in the string '{1}': {2}",
s2, s1, b)
If b Then
Dim index As Integer = s1.IndexOf(s2)
If index >= 0 Then
Console.WriteLine("'{0} begins at character position {1}",
s2, index + 1)
End If
End If
End Sub
End Class
'
' This example displays the following output:
' 'fox' is in the string 'The quick brown fox jumps over the lazy dog': True
' 'fox begins at character position 17
Keterangan
Metode ini melakukan perbandingan ordinal (peka huruf besar/kecil dan budaya). Pencarian dimulai pada posisi karakter pertama string ini dan berlanjut melalui posisi karakter terakhir.
Untuk melakukan perbandingan peka huruf besar/kecil atau ordinal yang sensitif terhadap budaya:
Pada .NET Core 2.1 dan versi yang lebih baru: Panggil Contains(String, StringComparison) kelebihan beban sebagai gantinya.
Pada .NET Framework: Create metode kustom. Contoh berikut mengilustrasikan salah satu pendekatan tersebut. Ini mendefinisikan String metode ekstensi yang menyertakan StringComparison parameter dan menunjukkan apakah string berisi substring saat menggunakan bentuk perbandingan string yang ditentukan.
using System;
public static class StringExtensions
{
public static bool Contains(this String str, String substring,
StringComparison comp)
{
if (substring == null)
throw new ArgumentNullException("substring",
"substring cannot be null.");
else if (! Enum.IsDefined(typeof(StringComparison), comp))
throw new ArgumentException("comp is not a member of StringComparison",
"comp");
return str.IndexOf(substring, comp) >= 0;
}
}
open System
open System.Runtime.CompilerServices
[<Extension>]
type StringExtensions =
[<Extension>]
static member Contains(str: string, substring, comp: StringComparison) =
if substring = null then
invalidArg "substring" "substring cannot be null"
if Enum.IsDefined(typeof<StringComparison>, comp) |> not then
invalidArg "comp" "comp is not a member of StringComparison"
str.IndexOf(substring, comp) >= 0
String s = "This is a string.";
String sub1 = "this";
Console.WriteLine("Does '{0}' contain '{1}'?", s, sub1);
StringComparison comp = StringComparison.Ordinal;
Console.WriteLine(" {0:G}: {1}", comp, s.Contains(sub1, comp));
comp = StringComparison.OrdinalIgnoreCase;
Console.WriteLine(" {0:G}: {1}", comp, s.Contains(sub1, comp));
// The example displays the following output:
// Does 'This is a string.' contain 'this'?
// Ordinal: False
// OrdinalIgnoreCase: True
let s = "This is a string."
let sub1 = "this"
printfn $"Does '{s}' contain '{sub1}'?"
let comp = StringComparison.Ordinal
printfn $" {comp:G}: {s.Contains(sub1, comp)}"
let comp2 = StringComparison.OrdinalIgnoreCase
printfn $" {comp2:G}: {s.Contains(sub1, comp2)}"
// The example displays the following output:
// Does 'This is a string.' contain 'this'?
// Ordinal: False
// OrdinalIgnoreCase: True
Imports System.Runtime.CompilerServices
Module StringExtensions
<Extension()>
Public Function Contains(str As String, substring As String,
comp As StringComparison) As Boolean
If substring Is Nothing Then
Throw New ArgumentNullException("substring",
"substring cannot be null.")
Else If Not [Enum].IsDefined(GetType(StringComparison), comp)
Throw New ArgumentException("comp is not a member of StringComparison",
"comp")
End If
Return str.IndexOf(substring, comp) >= 0
End Function
End Module
Public Module Example
Public Sub Main
Dim s As String = "This is a string."
Dim sub1 As String = "this"
Console.WriteLine("Does '{0}' contain '{1}'?", s, sub1)
Dim comp As StringComparison = StringComparison.Ordinal
Console.WriteLine(" {0:G}: {1}", comp, s.Contains(sub1, comp))
comp = StringComparison.OrdinalIgnoreCase
Console.WriteLine(" {0:G}: {1}", comp, s.Contains(sub1, comp))
End Sub
End Module
' The example displays the following output:
' Does 'This is a string.' contain 'this'?
' Ordinal: False
' OrdinalIgnoreCase: True
Jika Anda tertarik dengan posisi substring value
dalam instans saat ini, Anda dapat memanggil IndexOf metode untuk mendapatkan posisi awal kejadian pertamanya, atau Anda dapat memanggil LastIndexOf metode untuk mendapatkan posisi awal kejadian terakhirnya. Contohnya mencakup panggilan ke IndexOf(String) metode jika substring ditemukan dalam instans string.
Lihat juga
Berlaku untuk
Contains(Char)
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
- Sumber:
- String.Searching.cs
Mengembalikan nilai yang menunjukkan apakah karakter tertentu terjadi dalam string ini.
public:
bool Contains(char value);
public bool Contains (char value);
member this.Contains : char -> bool
Public Function Contains (value As Char) As Boolean
Parameter
- value
- Char
Karakter yang akan dicari.
Mengembalikan
true
value
jika parameter terjadi dalam string ini; jika tidak, false
.
Keterangan
Metode ini melakukan perbandingan ordinal (peka huruf besar/kecil dan budaya).