Intersoft WebCombo Documentation
AdditionalSearchFields Property
See Also  Example Send Feedback
ISNet.WebUI.WebCombo Namespace > WebCombo Class : AdditionalSearchFields Property






Returns or sets the additional data field used to match rows against user's input. Returns or sets the additional data field used to match rows against user's input.

Syntax

Visual Basic (Declaration) 
<DescriptionAttribute("Returns or sets the additional data fields used to match rows against user's input.")>
<ISNet.Serialization.XmlSerializableAttribute()>
<CategoryAttribute("Data")>
<NotifyParentPropertyAttribute(True)>
<ISNet.Serialization.BinarySerializableAttribute()>
<DefaultValueAttribute()>
Public Property AdditionalSearchFields As String
Visual Basic (Usage)Copy Code
Dim instance As WebCombo
Dim value As String
 
instance.AdditionalSearchFields = value
 
value = instance.AdditionalSearchFields
C# 
[DescriptionAttribute("Returns or sets the additional data fields used to match rows against user's input.")]
[ISNet.Serialization.XmlSerializableAttribute()]
[CategoryAttribute("Data")]
[NotifyParentPropertyAttribute(true)]
[ISNet.Serialization.BinarySerializableAttribute()]
[DefaultValueAttribute()]
public string AdditionalSearchFields {get; set;}
Delphi 
public read-write property AdditionalSearchFields: String; 
JScript 
DescriptionAttribute("Returns or sets the additional data fields used to match rows against user's input.")
ISNet.Serialization.XmlSerializableAttribute()
CategoryAttribute("Data")
NotifyParentPropertyAttribute()
ISNet.Serialization.BinarySerializableAttribute()
DefaultValueAttribute()
public function get,set AdditionalSearchFields : String
Managed Extensions for C++ 
[DescriptionAttribute("Returns or sets the additional data fields used to match rows against user's input.")]
[ISNet.Serialization.XmlSerializableAttribute()]
[CategoryAttribute("Data")]
[NotifyParentPropertyAttribute(true)]
[ISNet.Serialization.BinarySerializableAttribute()]
[DefaultValueAttribute()]
public: __property string* get_AdditionalSearchFields();
public: __property void set_AdditionalSearchFields( 
   string* value
);
C++/CLI 
[DescriptionAttribute("Returns or sets the additional data fields used to match rows against user's input.")]
[ISNet.Serialization.XmlSerializableAttribute()]
[CategoryAttribute("Data")]
[NotifyParentPropertyAttribute(true)]
[ISNet.Serialization.BinarySerializableAttribute()]
[DefaultValueAttribute()]
public:
property String^ AdditionalSearchFields {
   String^ get();
   void set (    String^ value);
}

Example

 

The following example shows you how to bind data source to a WebCombo using e.DataSource (old databinding mode) and use the AdditionalSearchFields programmatically in InitializeLayout event. Note that the name of the columns which will be inserted into the AdditionalSearchFields property should be separated by comma.
C#Copy Code
private void WebCombo1_InitializeDataSource(object sender, ISNet.WebUI.WebCombo.DataSourceEventArgs e)
{
    DataSet ds = new DataSet();
    oleDbDataAdapter1.Fill(ds,"Customers");
    e.DataSource =  ds;
    WebCombo1.DataTextField = "ContactName";
    WebCombo1.DataValueField = "CustomerID";
}

private void WebCombo1_InitializeLayout(object sender, ISNet.WebUI.WebCombo.LayoutEventArgs e)
{
    e.Layout.ComboMode = Mode.MultipleColumns;
    WebCombo1.AdditionalSearchFields = "ContactName, City, Country";
}

Remarks

You can set multiple data fields by using comma as separator. For example, OfficePhone, HomePhone

This property provides a convenient way for developers when the application require more than one data field to be searched instead of the specified DataTextField.

When you set a value to this property and AllowAutoQueryHandler is set to True, WebCombo will automatically search the user's input initially by DataTextField then followed by comma separated data fields assigned in this property. This feature is normally used in conjunction with MultipleColumns combo mode which allow users to see matched information in columns based on their input.

Note that this property will only be used to search against user's input, the displayed selected text will still be using the value specified in DataTextField. To learn more on this feature please read Additional Search Field.

You can set multiple data fields by using comma as separator. For example, OfficePhone, HomePhone

This property provides a convenient way for developers when the application require more than one data field to be searched instead of the specified DataTextField.

When you set a value to this property and AllowAutoQueryHandler is set to True, WebCombo will automatically search the user's input initially by DataTextField then followed by comma separated data fields assigned in this property. This feature is normally used in conjuction with MultipleColumns combomode which allow users to see matched information in columns based on their input.

Note that this property will only be used to search against user's input, the displayed selected text will still be using the value specified in DataTextField.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 Intersoft Solutions Corp. All Rights Reserved.