Compartir a través de


de la propiedad ParametersOutReadyEventArgs.ParameterValues

NOTA: esta API está ahora obsoleta.

Obtiene o establece los valores de parámetro proporcionados por un elemento Web que implementa la interfaz de IParametersOutProvider cuando se produce el evento ParametersOutReady

Espacio de nombres:  Microsoft.SharePoint.WebPartPages.Communication
Ensamblado:  Microsoft.SharePoint (en Microsoft.SharePoint.dll)

Sintaxis

'Declaración
<ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartParameters instead")> _
Public Property ParameterValues As String()
    Get
    Set
'Uso
Dim instance As ParametersOutReadyEventArgs
Dim value As String()

value = instance.ParameterValues

instance.ParameterValues = value
[ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartParameters instead")]
public string[] ParameterValues { get; set; }

Valor de propiedad

Tipo: []
Una matriz de valores de parámetro.

Comentarios

La propiedad ParameterValues es una matriz unidimensional de cadenas, donde cada cadena es el valor de un parámetro. El número y el orden de los parámetros contenidos en esta matriz deben coincidir con los especificados en el argumento de ParametersOutProviderInitEventArgs del evento ParametersOutProviderInit .

Ejemplos

En el ejemplo de código siguiente se muestra un método invalidado PartCommuncationMain que usa la propiedad ParameterValues para establecer los valores de parámetros de una instancia de la clase ParametersOutReadyEventArgs . Este ejemplo de código forma parte de un ejemplo más extenso de la interfaz IParametersOutProvider .

      ' Step #8: Override the PartCommunicationMain() method.
      ' The PartCommunicationMain method is called by the Web Part infrastructure on the client during the ASP.NET PreRender
      ' event to allow the part to pass its primary data to the other connected parts.
      ' It is important to always fire either the ParametersOutReady or the NoParametersOut event. Some parts
      ' may not behave properly if they are left waiting for this information.
      ' ParametersOutReady should be fired to send the parameters.
      ' NoParametersOut should be fired to indicate that there is no change in the parameters.
      Public Overrides Sub PartCommunicationMain()
         ' Ensure that all of the Web Part's controls are created.
         EnsureChildControls()
         
         ' Check if connected.
         If _connected Then
            ' If there is a listener, fire the ParametersOutReady event.
            If Not (ParametersOutReady Is Nothing) Then
               ' Need to create the ParametersOutReadyEventArgs object for the ParametersOutReady event.
               Dim parametersOutReadyEventArgs As New ParametersOutReadyEventArgs()
               
               If _parametersReadyButtonClicked Then 'ParametersOutReady Button was clicked
                  ' If there is a listener, fire the ParametersOutReady event.
                  If Not (ParametersOutReady Is Nothing) Then
                     ' Set the values to the values of the text
                     boxes.parametersOutReadyEventArgs.ParameterValues = New String(3) {}
                     parametersOutReadyEventArgs.ParameterValues(0) = _fontFamilyListBox.SelectedItem.Value
                     parametersOutReadyEventArgs.ParameterValues(1) = _fontColorListBox.SelectedItem.Value
                     parametersOutReadyEventArgs.ParameterValues(2) = _fontWeightListBox.SelectedItem.Value
                     parametersOutReadyEventArgs.ParameterValues(3) = _fontSizeListBox.SelectedItem.Value
                     
                     ' Fire the ParametersOutReady event.
                     RaiseEvent ParametersOutReady(Me, parametersOutReadyEventArgs)
                     
                     _parametersReadyButtonClicked = False
                  End If
               'The NoParametersOut button was clicked.
               ElseIf _noParametersOutButtonClicked Then
                  ' If there is a listener, fire the NoParametersOut event.
                  If Not (NoParametersOut Is Nothing) Then
                     ' Fire the event.
                     RaiseEvent NoParametersOut(Me, New EventArgs())
                     
                     _noParametersOutButtonClicked = False
                  End If
               ' The user didn't click any button.
               Else
                  ' If there is a listener, fire the NoParametersOut event.
                  If Not (NoParametersOut Is Nothing) Then
                     ' Fire the event.
                     RaiseEvent NoParametersOut(Me, New EventArgs())
                     
                     _noParametersOutButtonClicked = False
                  End If
               End If
            End If
         End If
      End Sub 'PartCommunicationMain
// Step #8: Override the PartCommunicationMain() method.
// The PartCommunicationMain method is called by the Web Part infrastructure on the client during the ASP.NET PreRender
// event to allow the part to pass its primary data to the other connected parts.
// It is important to always fire either the ParametersOutReady or the NoParametersOut event. Some parts
// may not behave properly if they are left waiting for this information.
// ParametersOutReady should be fired to send the parameters.
// NoParametersOut should be fired to indicate that there is no change in the parameters.

public override void PartCommunicationMain()
{
    // Ensure that all of the Web Part's controls are created.
    EnsureChildControls();

    // Check if connected.
    if(_connected)
    {
        // If there is a listener, fire the ParametersOutReady event.
        if(ParametersOutReady != null)
        {
            // Need to create the ParametersOutReadyEventArgs object for the ParametersOutReady event.
            ParametersOutReadyEventArgs parametersOutReadyEventArgs = new ParametersOutReadyEventArgs();

            if(_parametersReadyButtonClicked) //ParametersOutReady Button was clicked
            {
                // If there is a listener, fire the ParametersOutReady event.
                if(ParametersOutReady != null)
                {
                    // Set the values to the values of the text
boxes.
                    parametersOutReadyEventArgs.ParameterValues = new string[4];
                    parametersOutReadyEventArgs.ParameterValues[0] = _fontFamilyListBox.SelectedItem.Value;
                    parametersOutReadyEventArgs.ParameterValues[1] = _fontColorListBox.SelectedItem.Value;
                    parametersOutReadyEventArgs.ParameterValues[2] = _fontWeightListBox.SelectedItem.Value;
                    parametersOutReadyEventArgs.ParameterValues[3] = _fontSizeListBox.SelectedItem.Value;

                    // Fire the ParametersOutReady event.
                    ParametersOutReady(this, parametersOutReadyEventArgs);

                    _parametersReadyButtonClicked = false;
                }
            }
            //The NoParametersOut button was clicked.
            else if(_noParametersOutButtonClicked) 
            {
                // If there is a listener, fire the NoParametersOut event.
                if(NoParametersOut != null)
                {
                    // Fire the event.
                    NoParametersOut(this, new EventArgs());

                    _noParametersOutButtonClicked = false;
                }
            }
            // The user didn't click any button.
            else 
            {
                // If there is a listener, fire the NoParametersOut event.
                if(NoParametersOut != null)
                {
                    // Fire the event.
                    NoParametersOut(this, new EventArgs());

                    _noParametersOutButtonClicked = false;
                }
            }
        }
    }
}

Vea también

Referencia

clase ParametersOutReadyEventArgs

Miembros ParametersOutReadyEventArgs

Espacio de nombres Microsoft.SharePoint.WebPartPages.Communication