ConnectionsZone::GetText Property
Gets or sets the text shown in the section of the connection user interface (UI) that precedes the named consumer that will receive data from a provider.
Assembly: System.Web (in System.Web.dll)
public: property String^ GetText { virtual String^ get(); virtual void set(String^ value); }
Property Value
Type: System::String^A string that prefaces the named consumer in the connection. The default text is a culture-specific string supplied by the .NET Framework.
The GetText property takes effect in a specific connection scenario. When a user clicks the connect verb on a consumer control, the ConnectionsZone control displays a view that enables users to establish a connection to a provider. In the part of the UI that instructs users to choose a provider connection point, there is some text that precedes the named consumer that will participate in the connection. This text that precedes the consumer is the text in the GetText property. By default, the text value is Get.
You can set the value of this property declaratively within the opening tag of the <asp:connectionszone> element, by adding an attribute named GetText and assigning it a value. You can also set the property value programmatically.
The following code example demonstrates the use of the GetText property with a ConnectionsZone control. The example contains only the code for the Web page that demonstrates use of the property; for the other two code files needed to run the example, see the Example section of the ConnectionsZone class overview. The code example has four parts:
A user control that enables you to switch display modes on the Web page. Obtain this code from the ConnectionsZone class overview.
A source file that contains the code for a ZIP Code interface, and two WebPart controls acting as the provider and the consumer for a connection. Obtain this code from the ConnectionsZone class overview.
A Web page that hosts all the controls, declares an <asp:connectionszone> element, and shows how to use the property programmatically.
An explanation of how the example works in a browser.
The Web page declares an <asp:connectionszone> element and, in the Page_PreRender method, the code assigns a value to the GetText property.
Load the page in a browser. Switch to connect mode, using the Display Mode control. Click the verbs menu arrow on the ZIP Code Consumer control, and click the connect verb. In the view that opens for the existing connection, look in the providers section for the text that precedes the named consumer. This is the text assigned to the GetText property.
Available since 2.0