ActiveReports 8
ReplaceField Method
See Also  Example
GrapeCity.ActiveReports.v8 Assembly > GrapeCity.ActiveReports.SectionReportModel Namespace > RichTextBox Class : ReplaceField Method

fieldName
Name of the merge field to be replaced with the specified text.
replaceText
The value used to replace the specified field.

Glossary Item Box

Merges the contents of the RTF stream with the field values specified.

Syntax

Visual Basic (Declaration) 
Public Sub ReplaceField( _
   ByVal fieldName As System.String, _
   ByVal replaceText As System.String _
)
C# 
public void ReplaceField( 
   System.string fieldName,
   System.string replaceText
)

Parameters

fieldName
Name of the merge field to be replaced with the specified text.
replaceText
The value used to replace the specified field.

Remarks

A merge field is created using the InsertField method.

You can use this method to create mail-merge RTF content in your report.  The control will replace all occurrences of the field with the specified value.

Example

C#Copy Code
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());
}
Visual BasicCopy Code
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)
End Sub

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

RichTextBox Class
RichTextBox Members
InsertField Method

Walkthroughs

Mail Merge with RichText