RowReadyEventArgs.SelectionStatus - Propriété

Remarque : cette API est désormais obsolète.

Obtient ou définit le type de la ligne sélectionnée.

Espace de noms :  Microsoft.SharePoint.WebPartPages.Communication
Assembly :  Microsoft.SharePoint (dans Microsoft.SharePoint.dll)

Syntaxe

'Déclaration
<ObsoleteAttribute("Use System.Web.UI.WebControls.WebParts.IWebPartRow instead")> _
Public Property SelectionStatus As String
    Get
    Set
'Utilisation
Dim instance As RowReadyEventArgs
Dim value As String

value = instance.SelectionStatus

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

Valeur de propriété

Type : System.String
Le type de la ligne actuellement sélectionnée. SelectionStatus peut avoir une des trois valeurs qui respecte la casse suivantes.

Valeur

Description

Nouveau

Indique que la ligne nouvelle ou en étoile est sélectionnée dans un contrôle d'affichage feuille de données.

None

Indique qu'aucune ligne n'est sélectionnée.

Standard

Indique qu'une ligne standard est sélectionnée.

Exemples

L'exemple de code suivant montre une méthode substituée WebPart.PartCommunicationMain qui crée un objet RowReadyEventArgs , définit les valeurs de ligne et l'état de sélection, puis déclenche l'événement RowReady . Cet exemple de code fait partie d'un exemple plus développé fourni pour l'interface IRowProvider .

' 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 the RowReady event. Some parts
' may not behave properly if they are left waiting for this 
' information.
Public Overrides Sub PartCommunicationMain()
   ' Check if connected
   If _connected Then
      'If there is a listener, fire the RowReady event.
      If Not (RowReady Is Nothing) Then
         ' Create the RowReadyEventArgs object for the RowReady event.
         Dim rowReadyEventArgs As New RowReadyEventArgs()
               
         ' Declare data Variables.
         Dim selectionStatus As String = ""
         Dim dr(0) As DataRow
               
         ' If a row is selected, send the row.
          If _dataGrid.SelectedIndex > - 1 Then
             ' Generate an array containing the selected DataRow(s).
             dr(0) = CType(_dataGrid.DataSource, DataTable).Rows(_dataGrid.SelectedIndex)
                  
             ' Set the selection status.
              selectionStatus = "Standard"
               
          Else
             ' The user hasn't selected a row so send null.
             dr(0) = Nothing
                  
             ' Set selection status.
             selectionStatus = "None"
          End If
               
          ' Set Values
          rowReadyEventArgs.Rows = dr
          rowReadyEventArgs.SelectionStatus = selectionStatus
               
          ' Fire the RowReady event.
          RaiseEvent RowReady(Me, rowReadyEventArgs)
      End If
   End If
End Sub
// 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 the RowReady event. Some parts
// may not behave properly if they are left waiting for this 
// information.
public override void PartCommunicationMain()
{
    // Check if connected
    if(_connected)
    {
        //If there is a listener, fire the RowReady event.
        if (RowReady != null)
        {
            //Create the RowReadyEventArgs object for the RowReady event.
            RowReadyEventArgs rowReadyEventArgs = new RowReadyEventArgs();

            // Declare data Variables.
            string selectionStatus = "";
            DataRow[] dr = new DataRow[1];

            // If a row is selected, send the row.
            if ( _dataGrid.SelectedIndex > -1)
            {
                // Generate an array containing the selected DataRow(s).
                dr[0] = ((DataTable)_dataGrid.DataSource).Rows[_dataGrid.SelectedIndex];
            
                // Set the selection status.
                selectionStatus = "Standard";

            }
            else
            {
                // The user hasn't selected a row so send null.
                dr[0] = null;

                // Set selection status.
                selectionStatus = "None";
            }

            // Set Values
            rowReadyEventArgs.Rows = dr;
            rowReadyEventArgs.SelectionStatus = selectionStatus;

            // Fire the RowReady event.
            RowReady(this, rowReadyEventArgs);
        }
    }
}

Voir aussi

Référence

RowReadyEventArgs classe

RowReadyEventArgs - Membres

Microsoft.SharePoint.WebPartPages.Communication - Espace de noms