CatalogPartCollection.Contains(CatalogPart) Método

Definição

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Retorna um valor que indica se um determinado controle existe na coleção.

public:
 bool Contains(System::Web::UI::WebControls::WebParts::CatalogPart ^ catalogPart);

public bool Contains (System.Web.UI.WebControls.WebParts.CatalogPart catalogPart);

member this.Contains : System.Web.UI.WebControls.WebParts.CatalogPart -> bool

Public Function Contains (catalogPart As CatalogPart) As Boolean

Parâmetros

catalogPart

CatalogPart

Um CatalogPart que é verificado para determinar se ele está na coleção.

Retornos

Boolean

Um valor booliano que indica se um determinado controle está na coleção.

Exemplos

O exemplo de código a seguir demonstra como você pode determinar se um controle específico CatalogPart é membro de um CatalogPartCollection objeto . Para obter o código completo necessário para executar o exemplo, consulte a seção Exemplo do tópico visão geral da CatalogPartCollection classe.

O código no Button1_Click método cria um novo CatalogPartCollection objeto chamado myParts. O método usa o Contains método para determinar se o PageCatalogPart1 controle existe e, em caso afirmativo, recupera o controle e altera um valor de propriedade.

protected void Button1_Click(object sender, EventArgs e)
{
  ArrayList list = new ArrayList(2);
  list.Add(PageCatalogPart1);
  list.Add(DeclarativeCatalogPart1);
  // Pass an ICollection object to the constructor.
  CatalogPartCollection myParts = new CatalogPartCollection(list);
  foreach (CatalogPart catalog in myParts)
  {
    catalog.Description = "My " + catalog.DisplayTitle;
  }

  // Use the IndexOf property to locate a CatalogPart control.
  int PageCatalogPartIndex = myParts.IndexOf(PageCatalogPart1);
  myParts[PageCatalogPartIndex].ChromeType = PartChromeType.TitleOnly;

  // Use the Contains method to see if a CatalogPart control exists.
  if (myParts.Contains(PageCatalogPart1))
  {
    WebPart closedWebPart = null;
    WebPartDescriptionCollection descriptions = PageCatalogPart1.GetAvailableWebPartDescriptions();
    if (descriptions.Count > 0)
    {
      closedWebPart = PageCatalogPart1.GetWebPart(descriptions[0]);
      closedWebPart.AllowClose = false;
    }
  }
  
  // Use indexers to display the details of the CatalogPart controls.
  Label1.Text = String.Empty;
  Label1.Text =
    "<h3>PageCatalogPart Details</h3>" +
    "ID: " + myParts[0].ID + "<br />" +
    "Count: " + myParts[0].GetAvailableWebPartDescriptions().Count;
  Label1.Text += 
    "<h3>DeclarativeCatalogPart Details</h3>" +
    "ID: " + myParts["DeclarativeCatalogPart1"].ID + "<br />" +
    "Count: " + myParts["DeclarativeCatalogPart1"].GetAvailableWebPartDescriptions().Count;
}

Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs) 
    Dim list As New ArrayList(2)
    list.Add(PageCatalogPart1)
    list.Add(DeclarativeCatalogPart1)
    ' Pass an ICollection object to the constructor.
    Dim myParts As New CatalogPartCollection(list)
    Dim catalog As CatalogPart
    For Each catalog In  myParts
        catalog.Description = "My " + catalog.DisplayTitle
    Next catalog
    
    ' Use the IndexOf property to locate a CatalogPart control.
    Dim PageCatalogPartIndex As Integer = _
      myParts.IndexOf(PageCatalogPart1)
    myParts(PageCatalogPartIndex).ChromeType = PartChromeType.TitleOnly
    
    ' Use the Contains method to see if a CatalogPart control exists.
    If myParts.Contains(PageCatalogPart1) Then
        Dim closedWebPart As WebPart = Nothing
        Dim descriptions As WebPartDescriptionCollection = _
          PageCatalogPart1.GetAvailableWebPartDescriptions()
        If descriptions.Count > 0 Then
            closedWebPart = PageCatalogPart1.GetWebPart(descriptions(0))
            closedWebPart.AllowClose = False
        End If
    End If
    
    ' Use indexers to display the details of the CatalogPart controls.
    Label1.Text = String.Empty
    Label1.Text = _
      "<h3>PageCatalogPart Details</h3>" & _
      "ID: " & myParts(0).ID + "<br />" & _
      "Count: " & myParts(0).GetAvailableWebPartDescriptions().Count
    Label1.Text += _
      "<h3>DeclarativeCatalogPart Details</h3>" & _
      "ID: " & myParts("DeclarativeCatalogPart1").ID & "<br />" & _
      "Count: " & myParts("DeclarativeCatalogPart1") _
        .GetAvailableWebPartDescriptions().Count

End Sub 

Ao carregar a página em um navegador, você pode alternar a página para o modo de catálogo selecionando Catálogo no controle de lista suspensa Modo de Exibição . Adicione o controle personalizado WebPart à página marcando a caixa de seleção ao lado dele e clicando em Adicionar. Clique em Fechar para retornar a página para o modo de navegação. No controle que você acabou de adicionar, se você clicar no menu de verbos (a seta para baixo que aparece na barra de título) e clicar em Fechar, o controle será removido da página e adicionado ao PageCatalogPart controle. Retorne a página para o modo de catálogo e clique no link Catálogo de Páginas para exibir o conteúdo do PageCatalogPart controle. Observe que o controle que você fechou foi adicionado a ele. Clicar no botão Exibir Propriedades da Parte do Catálogo acessa o CatalogPartCollection objeto e exibe determinadas propriedades dos controles contidos CatalogPart . Marque a caixa de seleção ao lado do controle de servidor contido no controle , clique em PageCatalogPartAdicionar para adicioná-lo de volta à página e clique em Fechar para retornar a página para o modo de navegação. Clique no menu de verbos novamente no controle e observe que agora o verbo close desapareceu. Ele foi removido pelo código no método , quando usou o método para PageCatalogPart1verificar e, em Button1_Click seguida, definiu sua AllowClose propriedade falsecomo .Contains

Comentários

O Contains método permite que você determine se um objeto específico CatalogPart faz parte de um CatalogPartCollection objeto .

Confira também

• Contains(Object)
• Controles de Web Parts do ASP.NET