String.EndsWith

.NET Framework クラス ライブラリ リファレンス

String.EndsWith メソッド (String)

このインスタンスの末尾が、指定した文字列と一致するかどうかを判断します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function EndsWith ( _
    value As String _
) As Boolean

Visual Basic (使用法)

Dim instance As String
Dim value As String
Dim returnValue As Boolean

returnValue = instance.EndsWith(value)

C#

public bool EndsWith (
    string value
)

C++

public:
bool EndsWith (
    String^ value
)

J#

public boolean EndsWith (
    String value
)

JScript

public function EndsWith (
    value : String
) : boolean

パラメータ

value

比較対象の String。

戻り値
このインスタンスの末尾が value と一致する場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドは、value と、このインスタンスの末尾にある、value とまったく同じ長さの部分文字列とを比較し、両者が等しいかどうかを調べます。等しいという結果を得るためには、value が、この同じインスタンスへの参照であるか、このインスタンスの末尾と一致している必要があります。

このメソッドは、現在のカルチャを使用して、単語 (大文字/小文字を区別し、カルチャに依存した) 比較を実行します。

使用例

EndsWith メソッドを使用する方法を次のコード例に示します。

Visual Basic

Imports System

Public Class EndsWithTest

    Public Shared Sub Main()
        Dim strSource As String()
 = { "<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>"}

        ' 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
 (>).


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

        ' print out the initial array of strings
        Dim s As String
        For Each s In  strSource
            Console.WriteLine(s)

        Next s
        Console.WriteLine()

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

        ' print out the array of strings
        For Each s In  strSource
            Console.WriteLine(StripEndTags(s))
        Next s

    End Sub 'Main

    Private Shared Function
 StripEndTags(item As String) As
 String

        ' try to find a tag at the end of the line using EndsWith
        If item.Trim().EndsWith(">")
 Then

            ' now search for the opening tag...
            Dim lastLocation As Integer
 = item.LastIndexOf("</")
            If lastLocation >= 0 Then

                ' remove the identified section, if it is a valid region
                item = item.Substring(0, lastLocation)
            End If
        End If

    Return Item
    End Function 'StripEndTags

End Class 'EndsWithTest

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 ( string s in
 strSource )
            Console.WriteLine( StripEndTags( s ) );
    }

    private static string
 StripEndTags( string item ) {

            // 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 )
                    item =  item.Substring( 0, lastLocation );
            }

    return item;
    }
}

C++

using namespace System;
using namespace System::Collections;
String^ StripEndTags( String^ item )
{
   
   // 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 )
            item = item->Substring( 0, lastLocation );
   }

   return item;
}

int 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 (>).
   array<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
   IEnumerator^ myEnum1 = strSource->GetEnumerator();
   while ( myEnum1->MoveNext() )
   {
      String^ s = safe_cast<String^>(myEnum1->Current);
      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
   IEnumerator^ myEnum2 = strSource->GetEnumerator();
   while ( myEnum2->MoveNext() )
   {
      String^ s = safe_cast<String^>(myEnum2->Current);
      Console::WriteLine( StripEndTags( s ) );
   }
}

J#

import System.*;

public class EndsWithTest
{
    public static void main(String[]
 args)
    {
        // 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
        for (int iCtr = 0; iCtr < strSource.get_Length();
 iCtr++) {
            String s = (String)strSource.get_Item(iCtr);
            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
        for (int iCtr = 0; iCtr < strSource.get_Length();
 iCtr++) {
            String s = (String)strSource.get_Item(iCtr);
            Console.WriteLine(StripEndTags(s));
        }
    } //main

    private static String StripEndTags(String
 item)
    {
        // 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) {
                item = item.Substring(0, lastLocation);
            }
        }
        return item;
    } //StripEndTags
} //EndsWithTest

JScript

import System;

public class EndsWithTest {
    public static function
 Main() : void {

        // 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
 (>).

        var strSource : String [] = [ "<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
        for( var i : int
 in strSource )
            Console.WriteLine( strSource[i] );

        Console.WriteLine();
        Console.WriteLine("The following lists the items after the ends have
 been stripped:");
        Console.WriteLine("----------------------------------------------------------------");
        // print out the array of strings
        for( i in strSource )
            Console.WriteLine( StripEndTags( strSource[i] ) );
    }

    private static function
 StripEndTags( item : String ) : String {
        // try to find a tag at the end of the line using EndsWith
        if (item.Trim().EndsWith(">")) {
            // now search for the opening tag...
            var lastLocation : int = item.LastIndexOf(
 "</" );
            // remove the identified section, if it is a valid region
            if ( lastLocation >= 0 )
                item =  item.Substring( 0, lastLocation );
        }
        return item;
    }
}
EndsWithTest.Main();

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
String クラス
String メンバ
System 名前空間
StartsWith
Compare

String.EndsWith メソッド (String, StringComparison)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定された比較オプションを使って比較した場合に、この文字列の末尾が、指定された文字列と一致するかどうかを判断します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

<ComVisibleAttribute(False)> _
Public Function EndsWith ( _
    value As String, _
    comparisonType As StringComparison _
) As Boolean

Visual Basic (使用法)

Dim instance As String
Dim value As String
Dim comparisonType As StringComparison
Dim returnValue As Boolean

returnValue = instance.EndsWith(value, comparisonType)

C#

[ComVisibleAttribute(false)] 
public bool EndsWith (
    string value,
    StringComparison comparisonType
)

C++

[ComVisibleAttribute(false)] 
public:
bool EndsWith (
    String^ value, 
    StringComparison comparisonType
)

J#

/** @attribute ComVisibleAttribute(false) */ 
public boolean EndsWith (
    String value, 
    StringComparison comparisonType
)

JScript

ComVisibleAttribute(false) 
public function EndsWith (
    value : String, 
    comparisonType : StringComparison
) : boolean

パラメータ

value

比較する String オブジェクト。

comparisonType

この文字列と value との比較方法を決定する、いずれかの StringComparison 値。

戻り値
value パラメータがこの文字列の末尾と一致する場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。
ArgumentException	comparisonType が StringComparison 値ではありません。

解説

EndsWith メソッドは、value パラメータと、この文字列の末尾にある部分文字列とを比較し、両者が等しいかどうかを示す値を返します。等しいという結果を得るためには、value が、この同じインスタンスへの参照であるか、空の文字列 ("") であるか、または、この文字列の末尾と一致している必要があります。EndsWith メソッドによって実行される比較の種類は、comparisonType パラメータの値に依存します。

使用例

ある文字列が特定の部分文字列で終わっているかどうかを判断するコード例を次に示します。選択したカルチャ、大文字と小文字の区別、比較の種類 (序数ベースにしたかどうか) が実行結果に影響します。

Visual Basic

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

Imports System
Imports System.Threading

Class Sample
    Public Shared Sub Main()
 
        Dim intro As String
 = "Determine whether a string ends with another string, "
 & _
                              "using" & vbCrLf
 & "  different values of StringComparison."
        
        Dim scValues As StringComparison()
 =  { _
                        StringComparison.CurrentCulture, _
                        StringComparison.CurrentCultureIgnoreCase, _
                        StringComparison.InvariantCulture, _
                        StringComparison.InvariantCultureIgnoreCase, _
                        StringComparison.Ordinal, _
                        StringComparison.OrdinalIgnoreCase }
        '
        Console.Clear()
        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}."
 & vbCrLf, _
                           Thread.CurrentThread.CurrentCulture.Name)

        ' Determine whether three versions of the letter I are equal
 to each other. 
        Dim sc As StringComparison
        For Each sc In 
 scValues
            Console.WriteLine("StringComparison.{0}:",
 sc)
            Test("abcXYZ", "XYZ",
 sc)
            Test("abcXYZ", "xyz",
 sc)
            Console.WriteLine()
        Next sc
    
    End Sub 'Main
    
    
    Protected Shared Sub
 Test(ByVal x As String,
 ByVal y As String, _
                              ByVal comparison As
 StringComparison) 
        Dim resultFmt As String
 = """{0}"" {1}
 with ""{2}""."
        Dim result As String
 = "does not end"
        '
        If x.EndsWith(y, comparison) Then
            result = "ends"
        End If
        Console.WriteLine(resultFmt, x, result, y)
    
    End Sub 'Test
End Class 'Sample

'
'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".
'

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.Clear();
    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".

*/

C++

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

using namespace System;
using namespace System::Threading;

void Test(String^ testString, String^ searchString, 
     StringComparison comparison)
{
    String^ resultFormat = "\"{0}\" {1} with \"{2}\".";
    String^ resultString = "does not end";

    if (testString->EndsWith(searchString, comparison))
    {
        resultString = "ends";
    }
    Console::WriteLine(resultFormat, testString, resultString, searchString);
}

int main()
{
    String^ introMessage =
        "Determine whether a string ends with another string,
 " +
        "using\ndifferent values of StringComparison.";

    array<StringComparison>^ comparisonValues = {
        StringComparison::CurrentCulture,
        StringComparison::CurrentCultureIgnoreCase,
        StringComparison::InvariantCulture,
        StringComparison::InvariantCultureIgnoreCase,
        StringComparison::Ordinal,
        StringComparison::OrdinalIgnoreCase};

    Console::Clear();
    Console::WriteLine(introMessage);

    // 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);
    // Perform two tests for each StringComparison
    for each (StringComparison stringCmp in
 comparisonValues)
    {
        Console::WriteLine("StringComparison.{0}:", stringCmp);
        Test("abcXYZ", "XYZ", stringCmp);
        Test("abcXYZ", "xyz", stringCmp);
        Console::WriteLine();
    }
}

/*
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".

*/

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
String クラス
String メンバ
System 名前空間
StringComparison

String.EndsWith メソッド

String インスタンスの末尾が、指定された文字列と一致するかどうかを判断します。
オーバーロードの一覧

名前	説明
String.EndsWith (String)	このインスタンスの末尾が、指定した文字列と一致するかどうかを判断します。 .NET Compact Framework によってサポートされています。
String.EndsWith (String, StringComparison)	指定された比較オプションを使って比較した場合に、この文字列の末尾が、指定された文字列と一致するかどうかを判断します。 .NET Compact Framework によってサポートされています。
String.EndsWith (String, Boolean, CultureInfo)	指定されたカルチャを使って比較した場合に、この文字列の末尾が、指定された文字列と一致するかどうかを判断します。 .NET Compact Framework によってサポートされています。

参照

関連項目

String クラス
String メンバ
System 名前空間
StartsWith
Compare

String.EndsWith メソッド (String, Boolean, CultureInfo)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

指定されたカルチャを使って比較した場合に、この文字列の末尾が、指定された文字列と一致するかどうかを判断します。

名前空間: System
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function EndsWith ( _
    value As String, _
    ignoreCase As Boolean, _
    culture As CultureInfo _
) As Boolean

Visual Basic (使用法)

Dim instance As String
Dim value As String
Dim ignoreCase As Boolean
Dim culture As CultureInfo
Dim returnValue As Boolean

returnValue = instance.EndsWith(value, ignoreCase, culture)

C#

public bool EndsWith (
    string value,
    bool ignoreCase,
    CultureInfo culture
)

C++

public:
bool EndsWith (
    String^ value, 
    bool ignoreCase, 
    CultureInfo^ culture
)

J#

public boolean EndsWith (
    String value, 
    boolean ignoreCase, 
    CultureInfo culture
)

JScript

public function EndsWith (
    value : String, 
    ignoreCase : boolean, 
    culture : CultureInfo
) : boolean

パラメータ

value

比較する String オブジェクト。

ignoreCase

このインスタンスと value とを比較する際、大文字と小文字の違いを無視する場合は true。それ以外の場合は false。

culture

このインスタンスと value との比較方法を決定するカルチャ情報。culture が null 参照 (Visual Basic では Nothing) の場合は、現在のカルチャが使用されます。

戻り値
value パラメータがこの文字列の末尾と一致する場合は true。それ以外の場合は false。

例外

例外の種類	条件
ArgumentNullException	value が null 参照 (Visual Basic では Nothing) です。

解説

このメソッドは、value パラメータと、この文字列の末尾にある、value とまったく同じ長さの部分文字列とを比較し、両者が等しいかどうかを示す値を返します。等しいという結果を得るためには、value が、この同じインスタンスへの参照であるか、この文字列の末尾と一致している必要があります。

このメソッドは、大文字と小文字の区別とカルチャの種類を引数として受け取り、カルチャに依存する単語ベースの比較を実行します。

使用例

次に示すのは、ある文字列が別の文字列の末尾に出現するかどうかを調べるコード例です。EndsWith メソッドは、検索の結果に影響する大文字と小文字の区別の有無、およびさまざまなカルチャを指定して、複数回呼び出されます。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
String クラス
String メンバ
System 名前空間