GenericWebPart.Description Eigenschap
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee haalt u een korte woordgroep op die samenvat wat een besturingselement doet, voor gebruik in Knopinfo en catalogi van serverbesturingselementen.
public:
virtual property System::String ^ Description { System::String ^ get(); void set(System::String ^ value); };
public override string Description { get; set; }
member this.Description : string with get, set
Public Overrides Property Description As String
Waarde van eigenschap
Een tekenreeks die de functionaliteit van het besturingselement kort samenvat. De standaardwaarde is een lege tekenreeks ("").
Voorbeelden
In het volgende codevoorbeeld ziet u het declaratieve en programmatische gebruik van de Description eigenschap. De volledige broncode voor het voorbeeld vindt u in de sectie Voorbeeld van het GenericWebPart overzichtsonderwerp.
Het eerste deel van het codevoorbeeld laat zien hoe de Description eigenschap declaratief wordt ingesteld op een serverbesturingselement binnen een WebPartZone besturingselement.
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar"
Description="A calendar used as a GenericWebPart control."
CatalogIconImageUrl="MyCatalogIcon.gif"
TitleIconimageUrl ="MyTitleIcon.gif"
TitleUrl="MyInfoUrl.htm"
Width="250"/>
</ZoneTemplate>
</asp:WebPartZone>
<asp:WebPartZone ID="WebPartZone1" runat="server">
<ZoneTemplate>
<asp:Calendar ID="Calendar1" runat="server"
Title="My Calendar"
Description="A calendar used as a GenericWebPart control."
CatalogIconImageUrl="MyCatalogIcon.gif"
TitleIconimageUrl ="MyTitleIcon.gif"
TitleUrl="MyInfoUrl.htm"
Width="250"/>
</ZoneTemplate>
</asp:WebPartZone>
Het tweede deel van het codevoorbeeld laat zien hoe u via een programma toegang hebt tot de eigenschap om de waarde ervan in een label weer te geven.
protected void Button1_Click(object sender, EventArgs e)
{
Label2.Text =
@"<h3>Calendar GenericWebPart Properties</h3>" +
"<em>Title: </em>" + calendarPart.Title +
"<br />" +
"<em>CatalogIconImageUrl: </em>" + calendarPart.CatalogIconImageUrl +
"<br />" +
"<em>TitleUrl: </em>" + calendarPart.TitleUrl +
"<br />" +
"<em>Decription: </em>" + calendarPart.Description +
"<br />" +
"<em>TitleIconImageUrl: </em>" + calendarPart.TitleIconImageUrl +
"<br />" +
"<em>ChildControl ID: </em>" + calendarPart.ChildControl.ID +
"<br />" +
"<em>ChildControl Type: </em>" + calendarPart.ChildControl.GetType().Name +
"<br />" +
"<em>GenericWebPart ID: </em>" + calendarPart.ID +
"<br />" +
"<em>GenericWebPart Type: </em>" + calendarPart.GetType().Name +
"<br />" +
"<em>GenericWebPart Parent ID: </em>" + calendarPart.Parent.ID;
Label3.Text =
@"<h3>BulletedList GenericWebPart Properties</h3>" +
"<em>Title: </em>" + listPart.Title +
"<br />" +
"<em>CatalogIconImageUrl: </em>" + listPart.CatalogIconImageUrl +
"<br />" +
"<em>TitleUrl: </em>" + listPart.TitleUrl +
"<br />" +
"<em>Decription: </em>" + listPart.Description +
"<br />" +
"<em>TitleIconImageUrl: </em>" + listPart.TitleIconImageUrl +
"<br />" +
"<em>ChildControl ID: </em>" + listPart.ChildControl.ID +
"<br />" +
"<em>ChildControl Type: </em>" + listPart.ChildControl.GetType().Name +
"<br />" +
"<em>GenericWebPart ID: </em>" + listPart.ID +
"<br />" +
"<em>GenericWebPart Type: </em>" + listPart.GetType().Name +
"<br />" +
"<em>GenericWebPart Parent ID: </em>" + listPart.Parent.ID;
}
Protected Sub Button1_Click(ByVal sender As Object, ByVal e As EventArgs)
Label2.Text = _
"<h3>Calendar GenericWebPart Properties</h3>" & _
"<em>Title: </em>" & calendarPart.Title & _
"<br />" & _
"<em>CatalogIconImageUrl: </em>" & calendarPart.CatalogIconImageUrl & _
"<br />" & _
"<em>TitleUrl: </em>" & calendarPart.TitleUrl & _
"<br />" & _
"<em>Decription: </em>" & calendarPart.Description & _
"<br />" & _
"<em>TitleIconImageUrl: </em>" & calendarPart.TitleIconImageUrl & _
"<br />" & _
"<em>ChildControl ID: </em>" & calendarPart.ChildControl.ID & _
"<br />" & _
"<em>ChildControl Type: </em>" & calendarPart.ChildControl.GetType().Name & _
"<br />" & _
"<em>GenericWebPart ID: </em>" & calendarPart.ID & _
"<br />" & _
"<em>GenericWebPart Type: </em>" & calendarPart.GetType().Name & _
"<br />" & _
"<em>GenericWebPart Parent ID: </em>" & calendarPart.Parent.ID
Label3.Text = _
"<h3>BulletedList GenericWebPart Properties</h3>" & _
"<em>Title: </em>" & listPart.Title & _
"<br />" & _
"<em>CatalogIconImageUrl: </em>" & listPart.CatalogIconImageUrl & _
"<br />" & _
"<em>TitleUrl: </em>" & listPart.TitleUrl & _
"<br />" & _
"<em>Decription: </em>" & listPart.Description & _
"<br />" & _
"<em>TitleIconImageUrl: </em>" & listPart.TitleIconImageUrl & _
"<br />" & _
"<em>ChildControl ID: </em>" & listPart.ChildControl.ID & _
"<br />" & _
"<em>ChildControl Type: </em>" & listPart.ChildControl.GetType().Name & _
"<br />" & _
"<em>GenericWebPart ID: </em>" & listPart.ID & _
"<br />" & _
"<em>GenericWebPart Type: </em>" & listPart.GetType().Name & _
"<br />" & _
"<em>GenericWebPart Parent ID: </em>" & listPart.Parent.ID
End Sub
End Class
Opmerkingen
De Description eigenschapswaarde wordt meestal gebruikt als een beschrijvende tekenreeks voor een besturingselement in catalogi met lijsten met serverbesturingselementen en als knopinfo op de titelbalk van een besturingselement. De inhoud van de eigenschap wordt weergegeven in knopinfo wanneer een gebruiker de muisaanwijzer boven de titeltekst in de titelbalk van een besturingselement plaatst.
Met deze eigenschap wordt de basiseigenschap overschreven, zodat u toegang hebt tot de eigenschap op het onderliggende besturingselement alsof het een waar WebPart besturingselement is.
U kunt waarden instellen voor de eigenschap in uw besturingselement in de declaratieve markeringen van een webpagina, maar ook programmatisch. Als u een standaardwaarde voor de eigenschap wilt opgeven wanneer het besturingselement wordt gebruikt, kunt u de IWebPart interface implementeren.