System.Web 1.0.5000.0 2.0.0.0 Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details. System.EventArgs

The event is raised when the control displays an advertisement on the page.

For a list of initial property values for an instance of , see the constructor.

For more information about handling events, see Events and Delegates.

Provides data for the event of the control. This class cannot be inherited.

- Constructor

  Use this constructor to create and initialize a new instance of the class.

  The following table shows initial property values for an instance of .

  Property

  Initial value

  The value of the parameter if the parameter is not null; otherwise, an empty .

  If the parameter is not null, the value in the parameter that represents the alternate text; otherwise, .

  If the parameter is not null, the value in the parameter that represents the URL of the image to display; otherwise, .

  If the parameter is not null, the value in the parameter that represents the URL to navigate to; otherwise, .

  Initializes a new instance of the class.

  A containing the advertisement properties from the XML file.
  1.0.5000.0
  2.0.0.0
- Property
  System.Collections.IDictionary a

  Use the property to get a object that contains the advertisement properties for the currently displayed advertisement. The keys and values of the object are of type .

  The control randomly selects an advertisement each time the control is displayed on the Web page. The attributes for the selected advertisement are extracted from the advertisement XML file and stored in a object. When the control creates a new instance of the class, the property gets initialized with the object.

  Custom attributes about an advertisement, such as an advertisement caption, can also be included in the advertisement XML file. Use this property in the event handler to get the custom attributes.

  Gets a object that contains all the advertisement properties for the currently displayed advertisement.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the text to display if the image specified in the property is not available. In browsers that support the ToolTips feature, this text also appears as a ToolTip for the advertisement.

  A separate XML file contains the properties for the displayed advertisement. The control automatically sets the property with the corresponding alternate text entry in the XML file. This property can also be used to programmatically set the alternate text.

  Gets or sets the alternate text displayed in the control when the advertisement image is unavailable. Browsers that support the ToolTips feature display this text as a ToolTip for the advertisement.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the URL of an image to display for an advertisement in the control. You can use a relative or an absolute URL. A relative URL relates the location of the image to the location of the Web page or user control without specifying a complete path on the server. The path is relative to the location of the Web page. This makes it easier to move the entire site to another directory on the server without updating the path to the image in code. An absolute URL provides the complete path, so moving the site to another directory requires updating the code.

  A separate XML file contains the properties for the displayed advertisement. The control automatically sets the property with the corresponding image URL entry in the XML file containing the advertisement information. This property can also be used to programmatically set the image URL.

  If you use an advertisement file and specify a relative URL for this property, the URL is relative to the directory that the advertisement file is located in. If you set this property directly with a relative URL, instead of using the advertisement file, the URL is relative to the directory of the page or user control that contains the control.

  Gets or sets the URL of an image to display in the control.

  1.0.5000.0
  2.0.0.0
- Property
  System.String To be added: an object of type 'string'

  Use the property to specify the Web page to display when the control is clicked. A common use for this property is to redirect the navigation, when the control is clicked, to a page that can count the number of times the user clicked the advertisement before proceeding to the destination URL.

  A separate XML file contains the properties for the displayed advertisement. The control automatically sets the property with the corresponding navigation URL entry in the XML file. This property can also be used to programmatically set the navigation URL.

  If you use an advertisement file and specify a relative URL for this property, the URL is relative to the directory that the advertisement file is located in. If you set this property directly with a relative URL, instead of using the advertisement file, the URL is relative to the directory of the page or user control that contains the control.

  Gets or sets the Web page to display when the control is clicked.

  1.0.5000.0
  2.0.0.0