Freigeben über

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, die die ID des Steuerelements enthält.

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 die Auflistung von WebPartDescription Objekten in einem Katalog mithilfe der GetAvailableWebPartDescriptions Methode abgerufen und dann die Details der einzelnen WebPart Steuerelemente im Katalog angezeigt werden, indem die WebPartDescription Objekte durchlaufen werden. 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 kann nicht sein null; er 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 Steuerelementkatalog angezeigt wird.

Gilt für:

Weitere Informationen