StringCollection.Contains(String) Método

Definição

Espaço de Nomes:
System.Collections.Specialized
Assemblagens:
System.dll, System.Collections.Specialized.dll
Assemblagem:
System.dll
Assemblagem:
netstandard.dll

Determina se a cadeia especificada pertence à StringCollection.

public:
 bool Contains(System::String ^ value);
public bool Contains(string value);
member this.Contains : string -> bool
Public Function Contains (value As String) As Boolean

Parâmetros

value
String

A cadeia a localizar no StringCollection. O valor pode ser null.

Devoluções

Boolean

true se value for encontrado no StringCollection; caso contrário, false.

Exemplos

O exemplo de código seguinte pesquisa um elemento StringCollection .

using System;
using System.Collections;
using System.Collections.Specialized;

public class SamplesStringCollection  {

   public static void Main()  {

      // Creates and initializes a new StringCollection.
      StringCollection myCol = new StringCollection();
      String[] myArr = new String[] { "RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED" };
      myCol.AddRange( myArr );

      Console.WriteLine( "Initial contents of the StringCollection:" );
      PrintValues( myCol );

      // Checks whether the collection contains "orange" and, if so, displays its index.
      if ( myCol.Contains( "orange" ) )
         Console.WriteLine( "The collection contains \"orange\" at index {0}.", myCol.IndexOf( "orange" ) );
      else
         Console.WriteLine( "The collection does not contain \"orange\"." );
   }

   public static void PrintValues( IEnumerable myCol )  {
      foreach ( Object obj in myCol )
         Console.WriteLine( "   {0}", obj );
      Console.WriteLine();
   }
}

/*
This code produces the following output.

Initial contents of the StringCollection:
   RED
   orange
   yellow
   RED
   green
   blue
   RED
   indigo
   violet
   RED

The collection contains "orange" at index 1.

*/

Imports System.Collections
Imports System.Collections.Specialized

Public Class SamplesStringCollection   

   Public Shared Sub Main()

      ' Creates and initializes a new StringCollection.
      Dim myCol As New StringCollection()
      Dim myArr() As [String] = {"RED", "orange", "yellow", "RED", "green", "blue", "RED", "indigo", "violet", "RED"}
      myCol.AddRange(myArr)

      Console.WriteLine("Initial contents of the StringCollection:")
      PrintValues(myCol)

      ' Checks whether the collection contains "orange" and, if so, displays its index.
      If myCol.Contains("orange") Then
         Console.WriteLine("The collection contains ""orange"" at index {0}.", myCol.IndexOf("orange"))
      Else
         Console.WriteLine("The collection does not contain ""orange"".")
      End If 

   End Sub

   Public Shared Sub PrintValues(myCol As IEnumerable)
      Dim obj As [Object]
      For Each obj In  myCol
         Console.WriteLine("   {0}", obj)
      Next obj
      Console.WriteLine()
   End Sub

End Class


'This code produces the following output.
'
'Initial contents of the StringCollection:
'   RED
'   orange
'   yellow
'   RED
'   green
'   blue
'   RED
'   indigo
'   violet
'   RED
'
'The collection contains "orange" at index 1.
'

Observações

O Contains método pode confirmar a existência de uma cadeia antes de realizar operações adicionais.

Este método determina a igualdade chamando Object.Equals. As comparações de cadeias são sensíveis às maiúsculas e minúsculas.

Este método realiza uma pesquisa linear; portanto, este método é uma operação O(n), onde n é Count.

Este método utiliza os objetos Equals da coleção e CompareTo os métodos seguintes item para determinar se existe item .

Aplica-se a

Ver também