Procedura: dichiarare una connessione statica tra due controlli Web part

Articolo
10/22/2014

Aggiornamento: novembre 2007

Gli sviluppatori possono creare una connessione Web part statica tra due controlli server dichiarando la connessione nel formato di persistenza della pagina. Una connessione statica diventa un oggetto permanente in una pagina Web, come un controllo dichiarato. Tutti gli utenti possono vedere una connessione statica, perché è un oggetto condiviso. Non possono mai eliminare l'oggetto connessione, ma possono scollegarlo se dispongono delle apposite opzioni nell'interfaccia utente. Le connessioni statiche sono sempre disponibili per tutti gli utenti e non possono essere eliminate dalla pagina. Per ulteriori informazioni sulle connessioni, vedere WebPartConnection e Cenni preliminari sulle connessioni web part. Per informazioni dettagliate sulle connessioni statiche, vedere IsStatic. In questo argomento viene illustrato come creare una connessione statica tra due controlli WebPart.

Nota:
In questo argomento viene sottolineato come dichiarare una connessione statica nel codice di una pagina Web. Per dichiarare una connessione Web part statica tra due controlli server, i controlli devono essere essere impostati per la gestione delle connessioni e devono risiedere in una zona WebPartZoneBase. Per una descrizione completa dei requisiti per i controlli che partecipano alle connessioni, vedere WebPartConnection. Per ottenere il codice di esempio per i due controlli WebPart e la pagina Web usata per l'hosting della connessione statica illustrata in questo argomento, vedere la sezione degli esempi per la proprietà IsStatic.

In questo argomento viene sottolineato come dichiarare una connessione statica nel codice di una pagina Web. Per dichiarare una connessione Web part statica tra due controlli server, i controlli devono essere essere impostati per la gestione delle connessioni e devono risiedere in una zona WebPartZoneBase. Per una descrizione completa dei requisiti per i controlli che partecipano alle connessioni, vedere WebPartConnection. Per ottenere il codice di esempio per i due controlli WebPart e la pagina Web usata per l'hosting della connessione statica illustrata in questo argomento, vedere la sezione degli esempi per la proprietà IsStatic.

Per dichiarare i controlli server in una zona

Aggiungere un elemento <webpartzone> nella sezione del corpo della pagina Web che conterrà la connessione, quindi aggiungere un elemento <zonetemplate> figlio per includere i controlli server aggiunti nella zona. Il codice dovrebbe essere analogo al seguente:
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
  </ZoneTemplate>
</asp:WebPartZone>
```
Tra i tag dell'elemento <zonetemplate> dichiarare i controlli server che fungeranno da controlli provider e consumer in una connessione Web part. Questi controlli devono essere già impostati per la partecipazione alle connessioni. È inoltre possibile aggiungere altri controlli server nella zona. Come si è menzionato precedentemente in questo argomento, i controlli dichiarati in questo esempio vengono ottenuti dal codice di esempio rilevato nella proprietà IsStatic. Il codice per l'intera zona con i controlli server ha il seguente aspetto:
```
<asp:WebPartZone ID="WebPartZone1" >
  <ZoneTemplate>
    <aspSample:ZipCodeWebPart ID="zip1" 
       Title="ZIP Code Provider"  />
    <aspSample:WeatherWebPart ID="weather1"  
       Title="ZIP Code Consumer" />
  </ZoneTemplate>
</asp:WebPartZone> 
```

Per dichiarare una connessione statica

La pagina Web dovrebbe già disporre di un elemento <asp:webpartmanager>, necessario nelle pagine che utilizzano i controlli Web part. Aggiungere un elemento <staticconnections> come figlio dell'elemento <asp:webpartmanager> per includere una o più connessioni statiche dichiarate. Il codice dovrebbe essere analogo al seguente:
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
  </StaticConnections> 
</asp:WebPartManager> 
```
All'interno dell'elemento <staticconnections> dichiarare un elemento <asp:webpartconnection>. Per la connessione è necessario specificare i seguenti attributi obbligatori oltre agli attributi id e runat:
- ConsumerID: indica l'ID del controllo consumer nella connessione.
- ConsumerConnectionPointID: indica l'ID di un metodo di callback speciale nel consumer utilizzato per stabilire la connessione. Questo attributo è obbligatorio solo se il consumer dispone di più punti di connessione. Per informazioni dettagliate sui punti di connessione, vedere ConnectionPoint.
- ProviderID: indica l'ID del controllo provider nella connessione.
- ProviderConnectionPointID: indica l'ID di un metodo di callback speciale nel provider utilizzato per stabilire la connessione. Questo attributo è obbligatorio solo se il provider dispone di più punti di connessione.
Il codice completo per l'elemento <asp:webpartmanager> e la connessione statica figlio dovrebbe essere analogo al seguente:
```
<asp:WebPartManager ID="mgr"  >
  <StaticConnections>
    <asp:WebPartConnection ID="conn1"
      ConsumerConnectionPointID="ZipCodeConsumer"
      ConsumerID="weather1" 
      ProviderConnectionPointID="ZipCodeProvider" 
      ProviderID="zip1" />
  </StaticConnections>      
</asp:WebPartManager>
```

Vedere anche

Concetti

Cenni preliminari sulle connessioni web part

Cenni preliminari su Web part ASP.NET

Riferimenti

WebPartConnection

IsStatic

Condividi tramite