InsertField メソッド

テキスト内の現在の位置にRichTextBoxのマージフィールドを挿入します。

シンタックス

Visual Basic
C#

'宣言
 
Public Sub InsertField( _
   ByVal fieldName As String _
)

public void InsertField( 
   string fieldName
)

パラメータ

fieldName: 一意の名前を指定します。この名前は、ReplaceField メソッドでこのフィールドを参照するときに使用されます。

解説

InsertFieldを使用すると、メールマージコンテンツを作成して、実行時にテキストが RichTextBox コントロールに追加されるようにすることができます。メールマージフィールドを挿入すると、[ ]で囲んだフィールド名が追加され、テキストが保護設定されます。フィールド値の置換は自動的には実行されないため、親セクションのFormatイベントでRichTextBoxがフォーマットされるときに、ReplaceField メソッドを使用して、値を割り当てる必要があります。

使用例

private void ghCustomerID_Format(object sender, System.EventArgs eArgs)
{
    this.rtf.ReplaceField("CompanyName", "m_companyName");
    this.rtf.ReplaceField("ContactName", "m_contactName");
    this.rtf.ReplaceField("AddressLine", "m_addressLine");
    this.rtf.ReplaceField("City", "m_city");
    this.rtf.ReplaceField("Region", "m_region");
    this.rtf.ReplaceField("Country", "m_country");
    this.rtf.ReplaceField("PostalCode", "m_postalCode");
    this.rtf.ReplaceField("Date", System.DateTime.Today.Date.ToString());    
    this.rtf.InsertField("CustomerID");
}

Visual Basic

Private Sub ghCustomerID_Format(ByVal sender As Object, ByVal e As System.EventArgs) Handles ghCustomerID.Format
    Me.rtf.ReplaceField("CompanyName", "m_companyName")
    Me.rtf.ReplaceField("ContactName", "m_contactName")
    Me.rtf.ReplaceField("AddressLine", "m_addressLine")
    Me.rtf.ReplaceField("City", "m_city")
    Me.rtf.ReplaceField("Region", "m_region")
    Me.rtf.ReplaceField("Country", "m_country")
    Me.rtf.ReplaceField("PostalCode", "m_postalCode")
    Me.rtf.ReplaceField("Date", System.DateTime.Today.Date)
    Me.rtf.InsertField("CustomerID")
End Sub

参照

RichTextBox クラス
 RichTextBox メンバ
 ReplaceField メソッド