Metodo ParameterFieldDefinition.ApplyMinMaxValues

Applies the maximum and minimum values to a specified parameter in a report.

[Visual Basic]

Public Overridable Sub ApplyMinMaxValues(ByVal minValue As Object, ByVal maxValue As Object)

[C#]

public virtual void ApplyMinMaxValues ( objectminValue , objectmaxValue );

[C++]

public virtual void ApplyMinMaxValues (object * minValue, object * maxValue);

[VJ#]

public void ApplyMinMaxValues ( objectminValue , objectmaxValue );

Parametri

  • minValue
    Indica il valore minimo che è consentito assegnare al parametro.
  • maxValue
    Indica il valore massimo che è consentito assegnare al parametro.

Note

Le regole riportate di seguito si riferiscono ai valori minimo e massimo:

  • Campi di parametro stringa: I parametri forniscono la lunghezza minima e massima della stringa, invece di un valore compreso tra intervalli.
  • Campi di parametro booleani: Le proprietà non sono applicabili.
  • Il valore minimo impostato dovrebbe essere compreso nell'ambito delle proprietà EditMask, MaximumValue, e MinimumValue qualora impostato. Per ulteriori informazioni sulle maschere di modifica, vedere Limitazione del tipo di voci e di formati nei parametri.

Esempio

Nel seguente esempio vengono impostati i valori correnti di un parametro compreso tra intervalli, i valori predefiniti multipli di un parametro discreto di un sottoreport e i valori minimo e massimo di un parametro discreto.

[Visual Basic]

Private Sub SetParameters _
(ByVal startValue As Double, ByVal endValue As Double, _
ByVal discreteValue1 As Integer, _ 
ByVal discreteValue2 As Integer, _
ByVal minValue As Integer, ByVal maxValue As Integer)

   ' Dichiara le variabili richieste
   Dim discreteParam As New ParameterDiscreteValue()
   Dim rangeParam As New ParameterRangeValue()
   Dim paramField As ParameterFieldDefinition
   Dim currentValues As ParameterValues
   Dim defaultValues As ParameterValues

   ' Individua l'oggetto ParameterFieldDefinition in base al nome.
   paramField = _
   Report.DataDefinition.ParameterFields.Item("RangedParam")
   ' Imposta i valori iniziale e finale per il parametro compreso tra intervalli.
   rangeParam.StartValue = startValue
   rangeParam.EndValue = endValue
   ' Individua la raccolta ParameterValues e aggiunge i
   '  valori compresi tra intervalli.
   currentValues = paramField.CurrentValues
   currentValues.Add(rangeParam)
   ' Applica i valori dei parametri correnti.
   paramField.ApplyCurrentValues(currentValues)

   ' Individua l'oggetto ParameterFieldDefinition in base al nome e
   '  al nome del sottoreport.
   ' Nota: Il nome del sottoreport si trova nella proprietà 
   '  SubreportName di SubreportObject.
   paramField = _
   Report.DataDefinition.ParameterFields.Item("DiscreteParam", "sub1")

' Imposta i valori minimo e massimo.
   paramField.ApplyMinMaxValues(minValue, maxValue)

   ' Imposta il valore del parametro discreto.
   discreteParam.Value = discreteValue1
   ' Individua la raccolta ParameterValues e aggiunge il
   '  valore discreto.
   defaultValues = paramField.DefaultValues
   defaultValues.Add(discreteParam)
   ' Applica i valori del parametro predefiniti.
   paramField.ApplyDefaultValues(defaultValues)

   ' Ripristina l'oggetto ParameterDiscreteValue per aggiungere
   '  un secondo valore di parametro.
   discreteParam = New ParameterDiscreteValue()
   ' Imposta il valore del parametro discreto.
   discreteParam.Value = discreteValue2
   ' Individua la raccolta ParameterValues e aggiunge il
   '  valore discreto.
   defaultValues = paramField.DefaultValues
   defaultValues.Add(discreteParam)
   ' Applica i valori del parametro predefiniti.
   paramField.ApplyDefaultValues(defaultValues)
End Sub

[C#]

private void SetParameters (float startValue, float endValue, 
int discreteValue1, int discreteValue2, int minValue,
int maxValue)
{
   // Dichiara le variabili richieste
   ParameterDiscreteValue discreteParam = new
   ParameterDiscreteValue();
   ParameterRangeValue rangeParam = new ParameterRangeValue();
   ParameterFieldDefinition paramField;
   ParameterValues currentValues;
   ParameterValues defaultValues;

   // Individua l'oggetto ParameterFieldDefinition in base al nome.
   paramField = 
   Report.DataDefinition.ParameterFields["RangedParam"];
   // Imposta i valori iniziale e finale per il parametro compreso tra intervalli.
   rangeParam.StartValue = startValue;
   rangeParam.EndValue = endValue;
   // Individua la raccolta ParameterValues e aggiunge i
   //  valori compresi tra intervalli.
   currentValues = paramField.CurrentValues;
   currentValues.Add(rangeParam);
   // Applica i valori dei parametri correnti.
   paramField.ApplyCurrentValues(currentValues);
   
   // Individua l'oggetto ParameterFieldDefinition in base al nome e
   //  al nome del sottoreport.
   // Nota: Il nome del sottoreport si trova nella proprietà 
   //  SubreportName di SubreportObject.
   paramField = Report.DataDefinition.ParameterFields
   ["DiscreteParam", "sub1"];

// Imposta i valori minimo e massimo.
   paramField.ApplyMinMaxValues(minValue, maxValue);

   // Imposta il valore del parametro discreto.
   discreteParam.Value = discreteValue1;
   // Individua la raccolta ParameterValues e aggiunge il
   //  valore discreto.
   defaultValues = paramField.DefaultValues;
   defaultValues.Add(discreteParam);
   // Applica i valori del parametro predefiniti.
   paramField.ApplyDefaultValues(defaultValues);

   // Ripristina l'oggetto ParameterDiscreteValue per aggiungere
   //  un secondo valore di parametro.
   discreteParam = new ParameterDiscreteValue();
   // Imposta il valore del parametro discreto.
   discreteParam.Value = discreteValue2;
   // Individua la raccolta ParameterValues e aggiunge il
   //  valore discreto.
   defaultValues = paramField.DefaultValues;
   defaultValues.Add(discreteParam);
   // Applica i valori del parametro predefiniti.
   paramField.ApplyDefaultValues(defaultValues);
}

[C++]

void SetParameters (float startValue, float endValue, 
int discreteValue1, int discreteValue2, int minValue,
int maxValue)
{
   // Dichiara le variabili richieste
   ParameterDiscreteValue* discreteParam = new
   ParameterDiscreteValue();
   ParameterRangeValue* rangeParam = new ParameterRangeValue();
   ParameterFieldDefinition* paramField;
   ParameterValues* currentValues;
   ParameterValues* defaultValues;

   // Individua l'oggetto ParameterFieldDefinition in base al nome.
   paramField = 
   Report->DataDefinition->ParameterFields->Item["RangedParam"];
   // Imposta i valori iniziale e finale per il parametro compreso tra intervalli.
   rangeParam->StartValue = __box(startValue);
   rangeParam->EndValue = __box(endValue);
   // Individua la raccolta ParameterValues e aggiunge i
   //  valori compresi tra intervalli.
   currentValues = paramField->CurrentValues;
   currentValues->Add(rangeParam);
   // Applica i valori dei parametri correnti.
   paramField->ApplyCurrentValues(currentValues);
   
   // Individua l'oggetto ParameterFieldDefinition in base al nome e
   //  al nome del sottoreport.
   // Nota: Il nome del sottoreport si trova nella proprietà 
   //  SubreportName di SubreportObject.
   paramField = Report->DataDefinition->ParameterFields->Item
   ["DiscreteParam", "sub1"];

// Imposta i valori minimo e massimo.
   paramField->ApplyMinMaxValues(__box(minValue), __box(maxValue));

   // Imposta il valore del parametro discreto.
   discreteParam->Value = __box(discreteValue1);
   // Individua la raccolta ParameterValues e aggiunge il
   //  valore discreto.
   defaultValues = paramField->DefaultValues;
   defaultValues->Add(discreteParam);
   // Applica i valori del parametro predefiniti.
   paramField->ApplyDefaultValues(defaultValues);

   // Ripristina l'oggetto ParameterDiscreteValue per aggiungere
   //  un secondo valore di parametro.
   discreteParam = new ParameterDiscreteValue();
   // Imposta il valore del parametro discreto.
   discreteParam->Value = __box(discreteValue2);
   // Individua la raccolta ParameterValues e aggiunge il
   //  valore discreto.
   defaultValues = paramField->DefaultValues;
   defaultValues->Add(discreteParam);
   // Applica i valori del parametro predefiniti.
   paramField->ApplyDefaultValues(defaultValues);
};

[VJ#]

private void SetParameters (float startValue, float endValue, 
int discreteValue1, int discreteValue2, int minValue,
int maxValue)
{
   // Dichiara le variabili richieste
   ParameterDiscreteValue discreteParam = new
   ParameterDiscreteValue();
   ParameterRangeValue rangeParam = new ParameterRangeValue();
   ParameterFieldDefinition paramField;
   ParameterValues currentValues;
   ParameterValues defaultValues;

   // Individua l'oggetto ParameterFieldDefinition in base al nome.
   paramField = 
   Report.get_DataDefinition().get_ParameterFields().get_Item("RangedParam");
   // Imposta i valori iniziale e finale per il parametro compreso tra intervalli.
   rangeParam.set_StartValue((System.Int32)startValue);
   rangeParam.set_EndValue((System.Int32)endValue);
   // Individua la raccolta ParameterValues e aggiunge i
   //  valori compresi tra intervalli.
   currentValues = paramField.get_CurrentValues();
   currentValues.Add(rangeParam);
   // Applica i valori dei parametri correnti.
   paramField.ApplyCurrentValues(currentValues);
   
   // Individua l'oggetto ParameterFieldDefinition in base al nome e
   //  al nome del sottoreport.
   // Nota: Il nome del sottoreport si trova nella proprietà 
   //  SubreportName di SubreportObject.
   paramField = Report.get_DataDefinition().get_ParameterFields().get_Item
("DiscreteParam", "sub1");

// Imposta i valori minimo e massimo.
   paramField.ApplyMinMaxValues((System.Int32)minValue, (System.Int32)maxValue);

   // Imposta il valore del parametro discreto.
   discreteParam.set_Value((System.Int32)discreteValue1);
   // Individua la raccolta ParameterValues e aggiunge il
   //  valore discreto.
   defaultValues = paramField.get_DefaultValues();
   defaultValues.Add(discreteParam);
   // Applica i valori del parametro predefiniti.
   paramField.ApplyDefaultValues(defaultValues);

   // Ripristina l'oggetto ParameterDiscreteValue per aggiungere
   //  un secondo valore di parametro.
   discreteParam = new ParameterDiscreteValue();
   // Imposta il valore del parametro discreto.
   discreteParam.set_Value((System.Int32)discreteValue2);
   // Individua la raccolta ParameterValues e aggiunge il
   //  valore discreto.
   defaultValues = paramField.get_DefaultValues();
   defaultValues.Add(discreteParam);
   // Applica i valori del parametro predefiniti.
   paramField.ApplyDefaultValues(defaultValues);
}

Requisiti

Spazio dei nomi: CrystalDecisions.CrystalReports.Engine

Piattaforme: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP

Vedere anche

Classe ParameterFieldDefinition | Membri ParameterFieldDefinition | Spazio dei nomi CrystalDecisions.CrystalReports.Engine