WebPartDescription.ID Eigenschaft

Definition

Namespace:

System.Web.UI.WebControls.WebParts

Assembly:

System.Web.dll

Ruft die ID eines entsprechenden WebPart-Steuerelements ab.

public:
 property System::String ^ ID { System::String ^ get(); };

public string ID { get; }

member this.ID : string

Public ReadOnly Property ID As String

Eigenschaftswert

String

Eine Zeichenfolge mit der ID des Steuerelements.

Beispiele

Im folgenden Codebeispiel wird die programmgesteuerte Verwendung der ID -Eigenschaft veranschaulicht. Den vollständigen Code, der zum Ausführen dieses Codebeispiels erforderlich ist, finden Sie im Abschnitt Beispiel des WebPartDescription Themas Klassenübersicht.

Der folgende Code in der Button1_Click -Methode einer Webseite veranschaulicht, wie Sie die Auflistung von WebPartDescription Objekten in einem Katalog mithilfe der GetAvailableWebPartDescriptions -Methode abrufen und dann die Details der einzelnen WebPart Steuerelemente im Katalog anzeigen, indem Sie die WebPartDescription -Objekte durchlaufen. Beachten Sie, dass der ID Eigenschaftswert im folgenden Code abgerufen wird.

protected void Button1_Click(object sender, EventArgs e)
{
  Label1.Text = String.Empty;
  
  WebPartDescriptionCollection descriptions = 
    DeclarativeCatalogPart1.GetAvailableWebPartDescriptions();

  foreach (WebPartDescription desc in descriptions)
  {
    Label1.Text += "ID: " + desc.ID + "<br />" +
      "Title: " + desc.Title + "<br />" +
      "Description: " + desc.Description + "<br />" +
      "ImageUrl: " + desc.CatalogIconImageUrl + "<br />" +
      "<hr />";
  }
}

Protected Sub Button1_Click(ByVal sender As Object, _
  ByVal e As System.EventArgs)
  
  Label1.Text = String.Empty
      
  Dim descriptions As WebPartDescriptionCollection = _
   DeclarativeCatalogPart1.GetAvailableWebPartDescriptions()
          
  Dim desc As WebPartDescription
      
  For Each desc In descriptions
    Label1.Text += "ID: " & desc.ID & "<br />" & _
      "Title: " & desc.Title & "<br />" & _
      "Description: " & desc.Description & "<br />" & _
      "ImageUrl: " & desc.CatalogIconImageUrl & "<br />" & _
      "<hr />"
  Next
  
End Sub

Hinweise

Der Wert der ID Eigenschaft darf nicht sein null. Sie muss immer einen Wert aufweisen. Die ID -Eigenschaft entspricht direkt der Control.ID -Eigenschaft.

Die ID -Eigenschaft gilt nur, wenn sich eine Seite im Kataloganzeigemodus befindet und ein WebPart Steuerelement in einem Katalog von Steuerelementen angezeigt wird.

Weitere Informationen

• ID
• ASP.NET Webpart-Steuerelemente