Metodo DELETE (framework di ADO.NET Data Services)

Negli elenchi ed esempi seguenti vengono descritti i protocolli per l'utilizzo del metodo DELETE di ADO.NET Data Services. Altri comportamenti richiesti da Hypertext Transfer Protocol, RFC 2616 sono descritti in Requisiti HTTP comuni (framework di ADO.NET Data Services) e PUT, POST e DELETE (framework di ADO.NET Data Services).

I protocolli seguenti si applicano alle richieste HTTP che utilizzano il metodo DELETE.

• Se una richiesta DELETE include un corpo di entità, il corpo viene ignorato e la richiesta viene considerata come se non avesse alcun corpo di entità.

• Se l'URI di richiesta di una richiesta DELETE identifica una risorsa ADO.NET Data Services inesistente, la richiesta restituisce il codice di risposta 404 Non trovato.

• Quando un metodo DELETE nel contesto di una risorsa ADO.NET Data Services viene eseguito correttamente, la risorsa identificata dall'URI inviato viene eliminata e non risulta più disponibile nell'URI.

• Le risposte possibili di un metodo DELETE eseguito correttamente includono:

  • 200 OK, se la risposta include un'entità che descrive lo stato.

  • 202 Accettato, se l'azione non è stata ancora eseguita.

  • 204 Nessun contenuto, se l'azione è stata eseguita ma la risposta non include un'entità.

• In ADO.NET Data Services è necessario che l'azione richiesta venga completata prima della risposta a una richiesta DELETE. Le operazioni di eliminazione eseguite correttamente restituiscono sempre il codice di stato 204 Nessun contenuto.

Tipi che supportano il metodo DELETE

Negli esempi seguenti vengono illustrati gli elementi finali di sintassi del percorso HTTP dell'URL e le condizioni in cui gli elementi supportano il metodo DELETE. Ogni esempio contiene la descrizione di una richiesta DELETE e i risultati previsti.

È importante osservare che una richiesta DELETE a una risorsa che supporta il metodo DELETE potrebbe non riuscire se il principio richiedente non dispone di adeguati diritti per la risorsa specificata. In questo caso la richiesta restituisce il codice di risposta 401 Non autorizzato o 403 Accesso negato, a seconda che l'indicazione di un principio alternativo per il servizio dati possa consentire o meno la riuscita della richiesta, come è illustrato in Hypertext Transfer Protocol, RFC 2616.

/<EntitySet>

Nell'URI di esempio seguente viene illustrato un EntitySet come elemento finale:

/Customers

Descrizione:

• Non supporta il metodo DELETE.

• Per eseguire più di un'operazione di eliminazione in una sola richiesta, è necessario utilizzare un endpoint di operazione batch.

/<EntitySet>(keyPredicate)

Nell'URI di esempio seguente viene illustrato un keyPredicate come elemento finale:

/Customers('ALFKI')

Descrizione:

• Supporta il metodo DELETE.

• Esegue eliminazioni superficiali della sola istanza del tipo di entità identificata da keyPredicate in modo che una richiesta GET successiva al tipo di entità o a una delle sue proprietà restituisca il codice di risposta 404 Risorsa non trovata .

• È possibile, ma non obbligatorio, eseguire effetti collaterali aggiuntivi, ad esempio, eliminazioni a cascata, su altre risorse.

/<NavigationProperty> OPPURE /<LinkProperty>

Negli URI di esempio seguenti vengono illustrate le proprietà e i collegamenti di navigazione come elementi finali:

/Customers('ALFKI')/Orders
/Customers('ALFKI')/Orders(1)
/Employee(1)/Manager

Descrizione:

• Supporta il metodo DELETE solo nelle relazioni che terminano con cardinalità uguale a 1.

• Supporta il metodo DELETE se la proprietà o il collegamento di navigazione identifica una sola risorsa, ovvero la fine di una relazione con cardinalità = 1.

• Utilizza la stessa semantica degli URI /<EntitySet>(keyPredicate).

  • Supporta il metodo DELETE.

  • Esegue eliminazioni superficiali della sola istanza del tipo di risorsa identificata da keyPredicate in modo che una richiesta GET successiva al tipo di risorsa o a una delle sue proprietà restituisca il codice di risposta 404 Risorsa non trovata.

  • È possibile, ma non obbligatorio, eseguire effetti collaterali aggiuntivi, ad esempio, eliminazioni a cascata, su altre risorse.

• Non supporta il metodo DELETE se la proprietà o il collegamento di navigazione identifica più risorse, ovvero la fine "multipla" di una relazione.

• Viene restituito il codice di risposta 405 Metodo non consentito.

/<ComplexType>

Nell'URI di esempio seguente viene illustrato un ComplexType come elemento finale:

/Customers('ALFKI')/Address

Descrizione:

• Non supporta il metodo DELETE.

• In ADO.NET Data Services l'eliminazione di un ComplexType identificato dalla sintassi URI non è un'azione supportata.

/<Property>

Nell'URI di esempio seguente viene illustrata una proprietà come elemento finale:

/Customers('ALFKI')/FirstName

Descrizione:

• Non supporta il metodo DELETE.

• In ADO.NET Data Services l'eliminazione di una proprietà non è un'azione supportata.

/<Property>/$value

Nell'URI di esempio seguente viene illustrato un valore di proprietà come elemento finale:

/Customers('ALFKI')/FirstName/$value

Descrizione:

• Supporta il metodo DELETE.

• Imposta il valore della proprietà su Null se il testo della proprietà ammette valori Null.

• In caso contrario, viene generato un codice di risposta di errore.

• I codici di risposta HTTP includono:

  • Tipi che ammettono valori Null: 204 Nessun contenuto.

  • Tipi che non ammettono valori Null: 405 Metodo non consentito.

/<ServiceOperationName>

Nell'URI di esempio seguente viene illustrato un serviceOperationName e i parametri dell'operazione di servizio come elemento finale:

/CustomersByCity?city=London

Descrizione:

• Non supporta il metodo DELETE.

Vedere anche

Concetti

Metodo PUT (framework di ADO.NET Data Services)
Metodo POST (framework di ADO.NET Data Services)
Metodo DELETE (framework di ADO.NET Data Services)