Requisiti HTTP comuni (framework di ADO.NET Data Services)

Le specifiche riportate in questa sezione si applicano ai dati trasportati in tutti i formati supportati da ADO.NET Data Services.

Il formato di serializzazione utilizzato per una richiesta inviata da un client ad ADO.NET Data Services viene specificato dall'intestazione HTTP ContentType della richiesta. Il formato di una risposta da parte di un servizio dati viene specificato dall'intestazione HTTP Accept della richiesta. Come specificato nel documento RFC 2616, l'intestazione Accept indica che la risposta alla richiesta è limitata a un set specifico di tipi MIME.

Elaborazione dell'intestazione ACCEPT

In ADO.NET Data Services il formato della risposta viene determinato mediante le regole seguenti:

  • Se la richiesta include un'intestazione Accept, analizzare l'intestazione Accept utilizzando le regole definite nella sezione 14.1 del documento RFC 2616.

  • ADO.NET Data Services ignora qualsiasi regola di valore 'q' specificata nell'intestazione.

  • Il tipo MIME restituito dall'analisi dell'intestazione Accept viene quindi utilizzato come formato della risposta in base alle tabelle riportate di seguito.

Dopo avere determinato il tipo MIME del formato seguendo le regole di elaborazione dell'intestazione Accept, viene individuato il tipo MIME specifico della risposta utilizzando le regole riepilogate nelle tabelle riportate di seguito.

Il tipo MIME definito in un'intestazione Accept non può determinare un singolo tipo MIME in modo autonomo. Ad esempio, application/* non definisce un sottotipo singolo. Se il server non è in grado di inviare una risposta accettabile in base al valore dell'intestazione Accept, invia un codice di risposta 406 che indica che la richiesta non è accettabile in base al documento RFC 2616.

Raggruppamento dei tipi di supporto

Tipo MIME richiesto Tipo MIME di risposta Formato di serializzazione

*/*

application/atom+xml

ATOM/APP

text/*

Non supportato

Non supportato

application/*

Non supportato

Non supportato

Tipi di supporto singoli

Tipo MIME richiesto Tipo MIME di risposta Formato di serializzazione

text/xml

text/xml

ATOM/APP

application/xml

application/xml

ATOM/APP

application/atom+xml

application/atom+xml

ATOM/APP

application/json

application/json

JSON

Codici di risposta

Nella tabella seguente vengono riportati i codici di risposta utilizzati quando ADO.NET Data Services non è in grado di elaborare una richiesta:

Codice di risposta Descrizione

400 - Richiesta non valida

Il payload fornito in una richiesta viene formattato in modo non corretto per le regole di serializzazione definite in questa specifica.

404 - Non trovato

Una richiesta che utilizza uno dei verbi HTTP supportati dal servizio dati viene inviata a un URI che non esegue il mapping a una risorsa indirizzabile.

406 - Inaccettabile

Il server non è in grado di inviare una risposta accettabile in base all'intestazione Accept o alla direttiva della stringa di query in una richiesta.

422 - Entità non elaborabile

L'esecuzione di una richiesta HTTP destinata a modificare lo stato di una risorsa ADO.NET Data Services provocherebbe una violazione dello schema di ADO.NET Data Services, secondo quanto definito dalle regole illustrate in PUT, POST e DELETE (framework di ADO.NET Data Services).

405 - Metodo non consentito

Una richiesta inviata all'URI di ADO.NET Data Services utilizza un metodo non supportato dalla risorsa identificata dall'URI.

500 - Errore interno del server

Errore imprevisto durante l'esecuzione di una richiesta HTTP.

Vedere anche

Concetti

Formato URI di indirizzamento delle risorse (framework di ADO.NET Data Services)
Specifiche di ADO.NET Data Service

  • Last updated on