CatalogPartCollection.Item[] Proprietà

  • Riferimento

Definizione

Spazio dei nomi:
System.Web.UI.WebControls.WebParts
Assembly:
System.Web.dll

Restituisce un membro specifico dell'insieme a seconda della relativa posizione o di un identificatore univoco.

Overload

Item[Int32]

Ottiene o imposta un membro dell'insieme in base alla relativa posizione nell'insieme.
Item[String]

Restituisce un membro dell'insieme in base a un identificatore di stringa univoco.

Item[Int32]

Ottiene o imposta un membro dell'insieme in base alla relativa posizione nell'insieme.

public:
 property System::Web::UI::WebControls::WebParts::CatalogPart ^ default[int] { System::Web::UI::WebControls::WebParts::CatalogPart ^ get(int index); };
public System.Web.UI.WebControls.WebParts.CatalogPart this[int index] { get; }
member this.Item(int) : System.Web.UI.WebControls.WebParts.CatalogPart
Default Public ReadOnly Property Item(index As Integer) As CatalogPart

Parametri

index
Int32

Indice di un determinato oggetto CatalogPart nell'insieme.

Valore della proprietà

CatalogPart

Oggetto CatalogPart nell'indice specificato nell'insieme.

Esempio

Nell'esempio di codice seguente viene illustrato come accedere a un membro di un CatalogPartCollection oggetto usando il relativo indice. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento di panoramica della CatalogPartCollection classe.

Il codice nel Button1_Click metodo crea un nuovo CatalogPartCollection oggetto denominato myParts. Si noti che il metodo usa l'indicizzatore Item[] per recuperare informazioni dal primo membro della raccolta.

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

Quando si carica la pagina in un browser, è possibile passare alla modalità catalogo selezionando Catalogo nel controllo elenco a discesa Modalità di visualizzazione . Facendo clic sul pulsante Visualizza proprietà CatalogPart si accede all'oggetto CatalogPartCollection e vengono visualizzate determinate proprietà dei controlli contenuti CatalogPart . Il numero di controlli server disponibili all'interno del PageCatalogPart controllo viene ottenuto usando l'indicizzatore Item[] nel Button1_Click metodo .

Commenti

L'indicizzatore Item[] consente di accedere ai controlli sottostanti CatalogPart in un CatalogPartCollection oggetto per indice e di modificare i valori delle proprietà o i metodi di chiamata.

Vedi anche

Si applica a

Item[String]

Restituisce un membro dell'insieme in base a un identificatore di stringa univoco.

public:
 property System::Web::UI::WebControls::WebParts::CatalogPart ^ default[System::String ^] { System::Web::UI::WebControls::WebParts::CatalogPart ^ get(System::String ^ id); };
public System.Web.UI.WebControls.WebParts.CatalogPart this[string id] { get; }
member this.Item(string) : System.Web.UI.WebControls.WebParts.CatalogPart
Default Public ReadOnly Property Item(id As String) As CatalogPart

Parametri

id
String

Identificatore univoco di un particolare controllo CatalogPart in una raccolta.

Valore della proprietà

CatalogPart

Primo oggetto CatalogPart nell'insieme il cui ID corrisponde al valore di id.

Esempio

Nell'esempio di codice seguente viene illustrato come accedere a un membro di un CatalogPartCollection oggetto usando il relativo valore ID stringa. Per il codice completo necessario per eseguire l'esempio, vedere la sezione Esempio dell'argomento di panoramica della CatalogPartCollection classe.

Il codice nel Button1_Click metodo crea un nuovo CatalogPartCollection oggetto denominato myParts. Il metodo usa l'indicizzatore Item[] per recuperare informazioni sul DeclarativeCatalogPart controllo , che è il secondo membro della raccolta.

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

Quando si carica la pagina in un browser, è possibile passare alla modalità catalogo selezionando Catalogo nel controllo elenco a discesa Modalità di visualizzazione . Facendo clic sul pulsante Visualizza proprietà CatalogPart si accede all'oggetto CatalogPartCollection e vengono visualizzate determinate proprietà dei controlli contenuti CatalogPart . Il numero di controlli server disponibili all'interno del DeclarativeCatalogPart controllo viene ottenuto usando l'indicizzatore Item[] nel Button1_Click metodo .

Commenti

L'indicizzatore Item[] consente di accedere ai controlli sottostanti CatalogPart in un CatalogPartCollection oggetto usando un identificatore di stringa. Anche se l'oggetto CatalogPartCollection è di sola lettura, è possibile modificare i valori delle proprietà o chiamare i metodi sui controlli sottostanti a cui accede l'indicizzatore.

Vedi anche

Si applica a