String.EndsWith Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Bu dize örneğinin sonunun belirtilen bir dizeyle eşleşip eşleşmediğini belirler.

Aşırı Yüklemeler

EndsWith(String, Boolean, CultureInfo)	Belirtilen kültür kullanıldığında bu dize örneğinin sonunun belirtilen dizeyle eşleşip eşleşmediğini belirler.
EndsWith(String, StringComparison)	Belirtilen karşılaştırma seçeneği kullanıldığında bu dize örneğinin sonunun belirtilen dizeyle eşleşip eşleşmediğini belirler.
EndsWith(Char)	Bu dize örneğinin sonunun belirtilen karakterle eşleşip eşleşmediğini belirler.
EndsWith(String)	Bu dize örneğinin sonunun belirtilen dizeyle eşleşip eşleşmediğini belirler.

EndsWith(String, Boolean, CultureInfo)

Kaynak:

String.Comparison.cs

Belirtilen kültür kullanıldığında bu dize örneğinin sonunun belirtilen dizeyle eşleşip eşleşmediğini belirler.

C#

public bool EndsWith (string value, bool ignoreCase, System.Globalization.CultureInfo? culture);

Parametreler

value

String

Bu örneğin sonundaki alt dizeyle karşılaştıracak dize.

ignoreCase

Boolean

true karşılaştırma sırasında büyük/küçük harf yoksaymak; aksi takdirde , false.

culture

CultureInfo

Bu örneğin nasıl value karşılaştırıldığını belirleyen kültürel bilgiler. ise culturenull, geçerli kültür kullanılır.

Döndürülenler

Boolean

true value parametresi bu dizenin sonuyla eşleşiyorsa; eşleşmiyorsa, false.

Özel durumlar

ArgumentNullException

value, null değeridir.

Örnekler

Aşağıdaki örnek, bir dizenin başka bir dizenin sonunda olup olmadığını belirler. EndsWith yöntemi, büyük/küçük harf duyarlılığı, büyük/küçük harf duyarsızlığı ve aramanın sonuçlarını etkileyen farklı kültürler kullanılarak birkaç kez çağrılır.

C#

// This code example demonstrates the 
// System.String.EndsWith(String, ..., CultureInfo) method.

using System;
using System.Threading;
using System.Globalization;

class Sample 
{
    public static void Main() 
    {
        string msg1 = "Search for the target string \"{0}\" in the string \"{1}\".\n";
        string msg2 = "Using the {0} - \"{1}\" culture:";
        string msg3 = "  The string to search ends with the target string: {0}";
        bool result = false;
        CultureInfo ci;

        // Define a target string to search for.
        // U+00c5 = LATIN CAPITAL LETTER A WITH RING ABOVE
        string capitalARing = "\u00c5";

        // Define a string to search. 
        // The result of combining the characters LATIN SMALL LETTER A and COMBINING 
        // RING ABOVE (U+0061, U+030a) is linguistically equivalent to the character 
        // LATIN SMALL LETTER A WITH RING ABOVE (U+00e5).
        string xyzARing = "xyz" + "\u0061\u030a";

        // Display the string to search for and the string to search.
        Console.WriteLine(msg1, capitalARing, xyzARing);

        // Search using English-United States culture.
        ci = new CultureInfo("en-US");
        Console.WriteLine(msg2, ci.DisplayName, ci.Name);

        Console.WriteLine("Case sensitive:");
        result = xyzARing.EndsWith(capitalARing, false, ci);
        Console.WriteLine(msg3, result);

        Console.WriteLine("Case insensitive:");
        result = xyzARing.EndsWith(capitalARing, true, ci);
        Console.WriteLine(msg3, result);
        Console.WriteLine();

        // Search using Swedish-Sweden culture.
        ci = new CultureInfo("sv-SE");
        Console.WriteLine(msg2, ci.DisplayName, ci.Name);

        Console.WriteLine("Case sensitive:");
        result = xyzARing.EndsWith(capitalARing, false, ci);
        Console.WriteLine(msg3, result);

        Console.WriteLine("Case insensitive:");
        result = xyzARing.EndsWith(capitalARing, true, ci);
        Console.WriteLine(msg3, result);
    }
}

/*
This code example produces the following results (for en-us culture):

Search for the target string "Å" in the string "xyza°".

Using the English (United States) - "en-US" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: True

Using the Swedish (Sweden) - "sv-SE" culture:
Case sensitive:
  The string to search ends with the target string: False
Case insensitive:
  The string to search ends with the target string: False

*/

Açıklamalar

Bu yöntem, parametresini ile aynı uzunlukta olan bu dizenin sonundaki alt dizeyle valuekarşılaştırır value ve bunların eşit olup olmadığını belirten bir değer döndürür. Eşit olmak için, value bu aynı örneğe başvuru olmalıdır veya bu dizenin sonuyla eşleşmelidir.

Bu yöntem, belirtilen büyük/küçük harf ve kültürü kullanarak bir sözcük (kültüre duyarlı) karşılaştırması gerçekleştirir.

Ayrıca bkz.

• InvariantCulture

EndsWith(String, StringComparison)

Kaynak:

String.Comparison.cs

Belirtilen karşılaştırma seçeneği kullanıldığında bu dize örneğinin sonunun belirtilen dizeyle eşleşip eşleşmediğini belirler.

C#

public bool EndsWith (string value, StringComparison comparisonType);

Parametreler

value

String

Bu örneğin sonundaki alt dizeyle karşılaştıracak dize.

comparisonType

StringComparison

Bu dizenin nasıl value karşılaştırıldığını belirleyen numaralandırma değerlerinden biri.

Döndürülenler

Boolean

true value parametresi bu dizenin sonuyla eşleşiyorsa; eşleşmiyorsa, false.

Özel durumlar

ArgumentNullException

value, null değeridir.

ArgumentException

comparisonType bir StringComparison değer değildir.

Örnekler

Aşağıdaki örnek, bir dizenin belirli bir alt dizeyle bitip bitmeyeceğini belirler. Sonuçlar kültür seçiminden, büyük/küçük harf yoksayılıp yoksayılmayacağından ve sıralı karşılaştırma yapılıp yapılmayışından etkilenir.

C#

// This example demonstrates the 
// System.String.EndsWith(String, StringComparison) method.

using System;
using System.Threading;

class Sample 
{
    public static void Main() 
    {
        string intro = "Determine whether a string ends with another string, " +
                   "using\n  different values of StringComparison.";

        StringComparison[] scValues = {
            StringComparison.CurrentCulture,
            StringComparison.CurrentCultureIgnoreCase,
            StringComparison.InvariantCulture,
            StringComparison.InvariantCultureIgnoreCase,
            StringComparison.Ordinal,
            StringComparison.OrdinalIgnoreCase };

        Console.WriteLine(intro);

        // Display the current culture because the culture-specific comparisons
        // can produce different results with different cultures.
        Console.WriteLine("The current culture is {0}.\n", 
                       Thread.CurrentThread.CurrentCulture.Name);
        
        // Determine whether three versions of the letter I are equal to each other. 
        foreach (StringComparison sc in scValues)
        {
            Console.WriteLine("StringComparison.{0}:", sc);
            Test("abcXYZ", "XYZ", sc);
            Test("abcXYZ", "xyz", sc);
            Console.WriteLine();
        }
    }

    protected static void Test(string x, string y, StringComparison comparison)
    {
        string resultFmt = "\"{0}\" {1} with \"{2}\".";
        string result = "does not end";

        if (x.EndsWith(y, comparison))
            result = "ends";
        Console.WriteLine(resultFmt, x, result, y);
    }
}

/*
This code example produces the following results:

Determine whether a string ends with another string, using
  different values of StringComparison.
The current culture is en-US.

StringComparison.CurrentCulture:
"abcXYZ" ends with "XYZ".
"abcXYZ" does not end with "xyz".

StringComparison.CurrentCultureIgnoreCase:
"abcXYZ" ends with "XYZ".
"abcXYZ" ends with "xyz".

StringComparison.InvariantCulture:
"abcXYZ" ends with "XYZ".
"abcXYZ" does not end with "xyz".

StringComparison.InvariantCultureIgnoreCase:
"abcXYZ" ends with "XYZ".
"abcXYZ" ends with "xyz".

StringComparison.Ordinal:
"abcXYZ" ends with "XYZ".
"abcXYZ" does not end with "xyz".

StringComparison.OrdinalIgnoreCase:
"abcXYZ" ends with "XYZ".
"abcXYZ" ends with "xyz".

*/

Açıklamalar

yöntemi, EndsWith parametresini value bu dizenin sonundaki alt dizeyle karşılaştırır ve bunların eşit olup olmadığını belirten bir değer döndürür. Eşit olması için, value bu aynı dizeye başvuru olması, boş dize ("") olması veya bu dizenin sonuyla eşleşmesi gerekir. yöntemi tarafından EndsWith gerçekleştirilen karşılaştırma türü parametrenin comparisonType değerine bağlıdır.

Ayrıca bkz.

• StringComparison

EndsWith(Char)

Kaynak:

String.Comparison.cs

Bu dize örneğinin sonunun belirtilen karakterle eşleşip eşleşmediğini belirler.

C#

public bool EndsWith (char value);

Parametreler

value

Char

Bu örneğin sonundaki karakterle karşılaştıracak karakter.

Döndürülenler

Boolean

true bu örneğin sonuyla eşleşiyorsa; eşleşmiyorsa value , false.

Açıklamalar

Bu yöntem bir sıra (büyük/küçük harfe duyarlı ve kültüre duyarlı olmayan) karşılaştırması gerçekleştirir.

EndsWith(String)

Kaynak:

String.Comparison.cs

Bu dize örneğinin sonunun belirtilen dizeyle eşleşip eşleşmediğini belirler.

C#

public bool EndsWith (string value);

Parametreler

value

String

Bu örneğin sonundaki alt dizeyle karşılaştıracak dize.

Döndürülenler

Boolean

true bu örneğin sonuyla eşleşiyorsa; eşleşmiyorsa value , false.

Özel durumlar

ArgumentNullException

value, null değeridir.

Örnekler

Aşağıdaki örnek, bir dizideki her dizenin nokta (".") ile bitip bitmediğini gösterir.

C#

using System;

public class Example
{
   public static void Main()
   {
      String[] strings = { "This is a string.", "Hello!", "Nothing.", 
                           "Yes.", "randomize" };
      foreach (var value in strings) {
         bool endsInPeriod = value.EndsWith(".");
         Console.WriteLine("'{0}' ends in a period: {1}", 
                           value, endsInPeriod);
      }                            
   }
}
// The example displays the following output:
//       'This is a string.' ends in a period: True
//       'Hello!' ends in a period: False
//       'Nothing.' ends in a period: True
//       'Yes.' ends in a period: True
//       'randomize' ends in a period: False

Aşağıdaki örnek, html uç etiketlerini satırın sonundan kaldırmak için yöntemini kullanan EndsWith(String) bir yöntemi tanımlarStripEndTags. Satırın sonundaki StripEndTags birden çok HTML uç etiketinin kaldırıldığından emin olmak için yönteminin özyinelemeli olarak çağrıldığını unutmayın.

C#

using System;

public class EndsWithTest {
    public static void Main() {

        // process an input file that contains html tags.
        // this sample checks for multiple tags at the end of the line, rather than simply
        // removing the last one.
        // note: HTML markup tags always end in a greater than symbol (>).

        string [] strSource = { "<b>This is bold text</b>", "<H1>This is large Text</H1>",
                "<b><i><font color=green>This has multiple tags</font></i></b>",
                "<b>This has <i>embedded</i> tags.</b>",
                "This line simply ends with a greater than symbol, it should not be modified>" };

        Console.WriteLine("The following lists the items before the ends have been stripped:");
        Console.WriteLine("-----------------------------------------------------------------");

        // print out the initial array of strings
        foreach ( string s in strSource )
            Console.WriteLine( s );

        Console.WriteLine();

        Console.WriteLine("The following lists the items after the ends have been stripped:");
        Console.WriteLine("----------------------------------------------------------------");

        // print out the array of strings
        foreach (var s in strSource)
            Console.WriteLine(StripEndTags(s));
    }

    private static string StripEndTags( string item ) {

        bool found = false;

        // try to find a tag at the end of the line using EndsWith
        if (item.Trim().EndsWith(">")) {

            // now search for the opening tag...
            int lastLocation = item.LastIndexOf( "</" );

            // remove the identified section, if it is a valid region
            if ( lastLocation >= 0 ) {
                found = true;
                item =  item.Substring( 0, lastLocation );
            }
        }

        if (found)
           item = StripEndTags(item);

        return item;
    }
}
// The example displays the following output:
//    The following lists the items before the ends have been stripped:
//    -----------------------------------------------------------------
//    <b>This is bold text</b>
//    <H1>This is large Text</H1>
//    <b><i><font color=green>This has multiple tags</font></i></b>
//    <b>This has <i>embedded</i> tags.</b>
//    This line simply ends with a greater than symbol, it should not be modified>
//
//    The following lists the items after the ends have been stripped:
//    ----------------------------------------------------------------
//    <b>This is bold text
//    <H1>This is large Text
//    <b><i><font color=green>This has multiple tags
//    <b>This has <i>embedded</i> tags.
//    This line simply ends with a greater than symbol, it should not be modified>

Açıklamalar

Bu yöntem, bu örneğin sonundaki ile aynı uzunluktaki valuealt dizeyle karşılaştırılır value ve bunların eşit olup olmadığının bir göstergesini döndürür. Eşit olması için aynı value örneğe başvuru olması veya bu örneğin sonuyla eşleşmesi gerekir.

Bu yöntem, geçerli kültür kullanılarak bir sözcük (büyük/küçük harfe ve kültüre duyarlı) karşılaştırması gerçekleştirir.

Arayanlara Notlar

Dizeleri Kullanmak için En İyi Yöntemler bölümünde açıklandığı gibi, varsayılan değerlerin yerini alan dize karşılaştırma yöntemlerini çağırmaktan kaçınmanızı ve bunun yerine parametrelerin açıkça belirtilmesi gereken yöntemleri çağırmanızı öneririz. Geçerli kültürün dize karşılaştırma kurallarını kullanarak bir dizenin belirli bir alt dizeyle bitip bitmediğini belirlemek için, parametresi için değeriyle CurrentCulture yöntem aşırı yüklemesini çağırarak EndsWith(String, StringComparison) amacınıza açıkça sinyal verincomparisonType. Dil algılayan karşılaştırmaya ihtiyacınız yoksa kullanmayı Ordinalgöz önünde bulundurun.

Ayrıca bkz.

• StartsWith(String)
• Compare(String, String)