參數欄位執行階段自訂

您可以使用 Crystal Reports 的參數支援使用者輸入。這類參數適用於不同的用途。例如：

• 在資料庫欄位建立參數，並讓使用者指定該欄位值以便在報表中篩選資料。
• 使用參數欄位套用條件格式化至報表。
• 使用參數欄位定義排序次序。

下列範例說明如何透過程式碼在執行階段設定參數欄位值。它將說明如何設定兩個不同的參數。第一個是多重數值離散參數，第二個是範圍值參數。

若要在執行階段修改參數欄位

[Visual Basic]

' 宣告將參數傳遞給檢視器控制項
'  所需要的變數。
Dim paramFields As New ParameterFields()
Dim paramField As New ParameterField()
Dim discreteVal As New ParameterDiscreteValue()
Dim rangeVal As New ParameterRangeValue()

' 第一個參數是具有多重數值的離散參數。

' 設定參數欄位的名稱，該名稱必須與
'  報表中的參數相符。
paramField.ParameterFieldName = "Customer Name"

' 設定第一個離散值並將它傳遞給參數。
discreteVal.Value = "AIC Childrens"
paramField.CurrentValues.Add(discreteVal)

' 設定第二個離散值並將它傳遞給參數。
' 將 discreteVal 變數設定為新變數，
'  如此便不會覆寫之前的設定值。
discreteVal = New ParameterDiscreteValue()
discreteVal.Value = "Aruba Sport"
paramField.CurrentValues.Add(discreteVal)

' 加入參數至參數欄位集合。
paramFields.Add(paramField)

' 第二個參數是範圍值。將 paramField 變數設定為新變數，
'  如此便不會覆寫之前的設定值。
paramField = New ParameterField()

' 設定參數欄位的名稱，該名稱必須與
'  報表中的參數相符。
paramField.ParameterFieldName = "Customer ID"

' 設定範圍的起始值和結束值並傳遞至參數。
rangeVal.StartValue = 42
rangeVal.EndValue = 72
paramField.CurrentValues.Add(rangeVal)

' 加入第二個參數至參數欄位集合。
paramFields.Add(paramField)

' 設定參數欄位集合至檢視器控制項。
crystalReportViewer1.ParameterFieldInfo = paramFields

crystalReportViewer1.ReportSource = "c:\reports\my report.rpt"

[C#]

// 宣告將參數傳遞給檢視器控制項
//  所需要的變數。
ParameterFields paramFields = new ParameterFields ();
ParameterField paramField = new ParameterField ();
ParameterDiscreteValue discreteVal = new ParameterDiscreteValue ();
ParameterRangeValue rangeVal = new ParameterRangeValue ();

// 第一個參數是具有多重數值的離散參數。

// 設定參數欄位的名稱，該名稱必須與
//  報表中的參數相符。
paramField.ParameterFieldName = "Customer Name";

// 設定第一個離散值並將它傳遞給參數。
discreteVal.Value = "AIC Childrens";
paramField.CurrentValues.Add (discreteVal);

// 設定第二個離散值並將它傳遞給參數。
// 將 discreteVal 變數設定為新變數，
//  如此便不會覆寫之前的設定值。
discreteVal = new ParameterDiscreteValue ();
discreteVal.Value = "Aruba Sport";
paramField.CurrentValues.Add (discreteVal);

// 加入參數至參數欄位集合。
paramFields.Add (paramField);

// 第二個參數是範圍值。將 paramField 變數設定為新變數，
//  如此便不會覆寫之前的設定值。
paramField = new ParameterField ();

// 設定參數欄位的名稱，該名稱必須與
//  報表中的參數相符。
paramField.ParameterFieldName = "Customer ID";

// 設定範圍的起始值和結束值並
// 將它傳遞給參數。
rangeVal.StartValue = 42;
rangeVal.EndValue = 72;
paramField.CurrentValues.Add (rangeVal);

// 加入第二個參數至參數欄位集合。
paramFields.Add (paramField);

// 設定參數欄位集合至檢視器控制項。
crystalReportViewer1.ParameterFieldInfo = paramFields;

[C++]

// 宣告將參數傳遞給檢視器控制項
//  所需要的變數。
ParameterFields* paramFields = new ParameterFields ();
ParameterField* paramField = new ParameterField ();
ParameterDiscreteValue* discreteVal = new ParameterDiscreteValue ();
ParameterRangeValue* rangeVal = new ParameterRangeValue ();

// 第一個參數是具有多重數值的離散參數。
// 設定參數欄位的名稱，該名稱必須與
//  報表中的參數相符。
paramField->ParameterFieldName = "Customer Name";

// 設定第一個離散值並將它傳遞給參數。
String* val = "AIC Childrens";
discreteVal->Value = val;
paramField->CurrentValues->Add (discreteVal);

// 設定第二個離散值並將它傳遞給參數。
// 將 discreteVal 變數設定為新變數，
//  如此便不會覆寫之前的設定值。
discreteVal = new ParameterDiscreteValue ();
val = "Aruba Sport";
discreteVal->Value = val;
paramField->CurrentValues->Add (discreteVal);

// 加入參數至參數欄位集合。
paramFields->Add (paramField);

// 第二個參數是範圍值。將 paramField 變數設定為新變數，
//  如此便不會覆寫之前的設定值。
paramField = new ParameterField ();

// 設定參數欄位的名稱，該名稱必須與
//  報表中的參數相符。
paramField->ParameterFieldName = "Customer ID";

// 設定範圍的起始值和結束值並
//  將它傳遞給參數。
rangeVal->StartValue = __box(42);
rangeVal->EndValue = __box(72);
paramField->CurrentValues->Add (rangeVal);

// 加入第二個參數至參數欄位集合。
paramFields->Add (paramField);

// 設定參數欄位集合至檢視器控制項。
crystalReportViewer1->ParameterFieldInfo = paramFields;

crystalReportViewer1->ExportReport();

[VJ#]

// 宣告將參數傳遞給檢視器控制項
//  所需要的變數。
ParameterFields paramFields = new ParameterFields ();
ParameterField paramField = new ParameterField ();
ParameterDiscreteValue discreteVal = new ParameterDiscreteValue ();
ParameterRangeValue rangeVal = new ParameterRangeValue ();

// 第一個參數是具有多重數值的離散參數。

// 設定參數欄位的名稱，該名稱必須與
//  報表中的參數相符。
paramField.set_ParameterFieldName("Customer Name");

// 設定第一個離散值並將它傳遞給參數。
discreteVal.set_Value("AIC Childrens");
paramField.get_CurrentValues.Add (discreteVal);

// 設定第二個離散值並將它傳遞給參數。
// 將 discreteVal 變數設定為新變數，
//  如此便不會覆寫之前的設定值。
discreteVal = new ParameterDiscreteValue ();
discreteVal.set_Value("Aruba Sport");
paramField.get_CurrentValues().Add (discreteVal);

// 加入參數至參數欄位集合。
paramFields.Add (paramField);

// 第二個參數是範圍值。將 paramField 變數設定為新變數，
//  如此便不會覆寫之前的設定值。
paramField = new ParameterField ();

// 設定參數欄位的名稱，該名稱必須與
//  報表中的參數相符。
paramField.set_ParameterFieldName("Customer ID");

// 設定範圍的起始值和結束值並
//  將它傳遞給參數。
rangeVal.set_StartValue((System.Int32)42);
rangeVal.set_EndValue((System.Int32)72);
paramField.get_CurrentValues().Add (rangeVal);

// 加入第二個參數至參數欄位集合。
paramFields.Add (paramField);

// 設定參數欄位集合至檢視器控制項。
crystalReportViewer1.set_ParameterFieldInfo(paramFields);

請參閱

設定參數 | Windows Form Viewer 的繫結選項|Web Form Viewer 的繫結選項