This documentation is archived and is not being maintained.

MimeTextMatch.Capture Property

Gets or sets a value indicating the zero-based index of a MimeTextMatch within a group.

[Visual Basic]
Public Property Capture As Integer
[C#]
public int Capture {get; set;}
[C++]
public: __property int get_Capture();
public: __property void set_Capture(int);
[JScript]
public function get Capture() : int;
public function set Capture(int);

Property Value

A 32-bit signed integer. The default value is 0, indicating that the MimeTextMatch is the first instance within a group.

Exceptions

Exception Type Condition
ArgumentException The property value is negative.

Remarks

For more information, see the Group and Matches properties.

Example

[Visual Basic] 
' Create an InputBinding.
Dim myInputBinding As New InputBinding()
Dim myMimeTextBinding As New MimeTextBinding()
Dim myMimeTextMatchCollection1 As New MimeTextMatchCollection()
Dim myMimeTextMatch(2) As MimeTextMatch
myMimeTextMatchCollection1 = myMimeTextBinding.Matches

' Intialize the MimeTextMatch. 
For myInt = 0 To 2

   ' Get a new MimeTextMatch.
   myMimeTextMatch(myInt) = New MimeTextMatch()

   ' Assign values to properties of the MimeTextMatch.
   myMimeTextMatch(myInt).Name = "Title" + Convert.ToString(myInt)
   myMimeTextMatch(myInt).Type = "*/*"
   myMimeTextMatch(myInt).Pattern = "TITLE>(.*?)<"
   myMimeTextMatch(myInt).IgnoreCase = True
   myMimeTextMatch(myInt).Capture = 2
   myMimeTextMatch(myInt).Group = 2
   If myInt <> 0 Then

      ' Assign the Repeats property if the index is not 0.
      myMimeTextMatch(myInt).Repeats = 2
   Else

      ' Assign the RepeatsString property if the index is 0.
      myMimeTextMatch(myInt).RepeatsString = "4"
   End If

   ' Add 'MimeTextMatch' instance to collection.
   myMimeTextMatchCollection1.Add(myMimeTextMatch(myInt))
Next myInt

[C#] 
// Create an InputBinding.
InputBinding myInputBinding = new InputBinding();
MimeTextBinding myMimeTextBinding = new MimeTextBinding();
MimeTextMatchCollection myMimeTextMatchCollection1 = 
   new MimeTextMatchCollection();
MimeTextMatch[] myMimeTextMatch = new MimeTextMatch[3];        
myMimeTextMatchCollection1 = myMimeTextBinding.Matches;

// Intialize the MimeTextMatch. 
for( myInt = 0 ; myInt < 3 ; myInt++ )
{
   // Get a new MimeTextMatch.
   myMimeTextMatch[ myInt ] = new MimeTextMatch();

   // Assign values to properties of the MimeTextMatch.
   myMimeTextMatch[ myInt ].Name = "Title" + Convert.ToString( myInt );
   myMimeTextMatch[ myInt ].Type = "*/*";
   myMimeTextMatch[ myInt ].Pattern = "TITLE&gt;(.*?)&lt;";
   myMimeTextMatch[ myInt ].IgnoreCase = true;
   myMimeTextMatch[ myInt ].Capture = 2;
   myMimeTextMatch[ myInt ].Group = 2;     
   if( myInt != 0 )
   {
      // Assign the Repeats property if the index is not 0.
      myMimeTextMatch[ myInt ].Repeats = 2;
   }
   else
   {
      // Assign the RepeatsString property if the index is 0.
      myMimeTextMatch[ myInt ].RepeatsString = "4";
   }
   // Add the MimeTextMatch to the collection.
   myMimeTextMatchCollection1.Add( myMimeTextMatch[ myInt ] );
}

[C++] 
// Create an InputBinding.
InputBinding* myInputBinding = new InputBinding();
MimeTextBinding* myMimeTextBinding = new MimeTextBinding();
MimeTextMatchCollection* myMimeTextMatchCollection1 =
   new MimeTextMatchCollection();
MimeTextMatch* myMimeTextMatch[] = new MimeTextMatch*[3];
myMimeTextMatchCollection1 = myMimeTextBinding->Matches;

// Intialize the MimeTextMatch.
for( myInt = 0 ; myInt < 3 ; myInt++ )
{
   // Get a new MimeTextMatch.
   myMimeTextMatch[ myInt ] = new MimeTextMatch();

   // Assign values to properties of the MimeTextMatch.
   myMimeTextMatch[ myInt ]->Name = String::Format( S"Title{0}", Convert::ToString(myInt) );
   myMimeTextMatch[ myInt ]->Type = S"*/*";
   myMimeTextMatch[ myInt ]->Pattern = S"TITLE&gt;(.*?)&lt;";
   myMimeTextMatch[ myInt ]->IgnoreCase = true;
   myMimeTextMatch[ myInt ]->Capture = 2;
   myMimeTextMatch[ myInt ]->Group = 2;
   if( myInt != 0 )
   {
      // Assign the Repeats property if the index is not 0.
      myMimeTextMatch[ myInt ]->Repeats = 2;
   }
   else
   {
      // Assign the RepeatsString property if the index is 0.
      myMimeTextMatch[ myInt ]->RepeatsString = S"4";
   }
   // Add the MimeTextMatch to the collection.
   myMimeTextMatchCollection1->Add( myMimeTextMatch[ myInt ] );
}

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

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

See Also

MimeTextMatch Class | MimeTextMatch Members | System.Web.Services.Description Namespace

Show: