Méthodes décodées

Dernière modification : mardi 23 mars 2010

S’applique à : SharePoint Foundation 2010

Les sections décodées de cette référence ne montrent pas le code que vous voyez lorsque vous utilisez un programme comme le Moniteur réseau, qui permet un examen du trafic réseau vers et depuis le serveur au niveau des paquets, capturant ces derniers entre les extensions serveur FrontPage Microsoft et une application cliente comme Microsoft Office FrontPage 2003. Cette rubrique décrit le code observé dans un programme de capture des paquets et les étapes suivies dans cette référence pour rendre les exemples lisibles.

Notes

En fonction du système d'exploitation et du programme utilisés, vous pouvez filtrer les paquets en tant que paquets HTTP ou TCP. Si vous utilisez le filtre TCP, vous devez inspecter chaque paquet TCP de la commande HTTP POST. Par exemple, sur les systèmes UNIX, le protocole HTTP est toujours intégré au paquet TCP.

Le premier paquet capturé est généralement le paquet HTTP POST. Il est suivi du paquet Keep-Alive. Le dernier paquet ou jeu de paquets transmis contient le code de retour de la méthode. Ce code se présente toujours sous la forme d'une ou plusieurs pages HTML. La plupart des codes de retour incluent des métaclés contenant des informations sur les données transmises.

Chaque requête POST envoyée par une application cliente à l'aide de Microsoft SharePoint Foundation ou des extensions serveur FrontPage Microsoft comprend une chaîne qui spécifie la méthode RPC à exécuter et tout paramètre requis pour la méthode. À titre d'exemple, la requête POST suivante implémente les extensions serveur FrontPage :

POST./site_url/_vti_bin/_vti_aut/author.dll 
HTTP/1.0CRLF
Date: Thu, 03 Dec 2003 19:09:16 GMTCRLF
MIME-Version: 1.0CRLF
User-Agent: MSFrontPage/6.0CRLF
Host: server_nameCRLF
Accept: auth/sicilyCRLF
Authorization: Basic cm9iZjpUS3NvKjUwCRLF
Content-Length: 343CRLF
Content-Type: application/x-www-form-urlencodedCRLF
X-Vermeer-Content-Type: application/x-www-form-urlencodedCRLF
method=list+documents%3a6%2e0%2e2%2e5420service%5
fname=%2fallnew&listHiddenDocs=false&listExplorerDocs=
   false&listRecurse=false&listFiles=true&listFolders=true
&listLinkInfo=true&listIncludeParent=true&listDerived=
   false&listBorders=false&listChildWebs=true
&initialUrl=&platform=WinI386&folderList=
   %5b%3bTW%7c09+Nov+1998+17%3a03%3a25+%2d0000%5d.LF

L'exemple précédent montre le format envoyé par l'application cliente. Toutefois, lorsque vous capturez un POST à l'aide d'un programme comme le Moniteur réseau, il s'affiche comme suit :

POST./site_url/_vti_bin/_vti_aut/author.dll.HTTP/1.0..Date:.Tue,.19.Jan.2003.19:58:GMT.. 
MIME-Version:.1.0..User-Agent:.MSFrontPage/6.0..Host:.v-rfrank3.. 
Accept:.auth/sicily..Authorization:.Basic.di1yZnJhbms6VEtzbzUwKg==.. 
Content-Length:.317..Content-Type:.application/x-www-form-urlencode.. 
X-Vermeer-Content-Type:.application/x-www-form-urlencoded.... 
method=list+documents%3a6%2e0%2e2%2e5420&service%5fname=&listHiddenDocs=false 
&listExplorerDocs=false&listRecurse=false&listFiles=true&listFolders=true 
&listLinkInfo=true&listIncludeParent=true&listDerived=false&listBorders=false 
&listChildWebs=true&initialUrl=&folderList=%5b%3bTW%7c13+Jan+2003+16%3a16%3a17+%2d0000%5d.

L'exemple précédent montre un flux de données qui est initialement incorporé dans un autre code, comme suit :

00000030 50 4F 53 54 20 2F 70 72 6F 64 
POST./site_url/ 00000040 39 38 2F 5F 76 74 69 5F 62 69 6E 2F 5F 76 74 69 
98/_vti_bin/_vti 00000050 5F 61 75 74 2F 61 75 74 68 6F 72 2E 64 6C 6C 20 
_aut/author.dll. 00000060 48 54 54 50 2F 31 2E 30 0D 0A 44 61 74 65 3A 20 
HTTP/1.0..Date:. 00000070 54 75 65 2C 20 31 39 20 4A 61 6E 20 31 39 39 39 
Tue,.19.Jan.2003 00000080 20 32 30 3A 33 35 3A 32 36 20 47 4D 54 0D 0A 4D 
.19:58:GMT..M

Pour rendre ce type de code plus lisible dans la référence, plusieurs modifications sont apportées. Tout d'abord, le code au début de chaque ligne est supprimé pour révéler la commande POST. Ensuite, tous les sauts de ligne restants sont supprimés pour former un flux de données. Ensuite, des sauts de ligne sont rajoutés pour le rendre plus lisible. Les points (.) de ce flux représentent les caractères ou les espaces de contrôle et sont également supprimés. L'exemple suivant illustre le résultat de ces modifications, qui reste difficile à comprendre.

method=list+documents%3a6%2e0%2e2%2e5420&service%5fname=%2fallnew&listHiddenDocs=false 
&listExplorerDocs=false&listRecurse=false&listFiles=true&listFolders=true 
&listLinkInfo=true&listIncludeParent=true&listDerived=false&listBorders=false 
&listChildWebs=true &initialUrl=&platform=WinI386 
&folderList=%5b%3bTW%7c09+Nov+2003+17%3a03%3a25+%2d0000%5d.

Pour que le code puisse apparaître dans la section Décodée de la rubrique d'une méthode, d'autres modifications sont apportées. Le résultat est le suivant :

POST./allnew/_vti_bin/_vti_aut/author.dll 
HTTP/1.0CRLF
.
.
.
method=list+documents:6.0.2.5420 &service_name=/allnew 
&listHiddenDocs=false &listExplorerDocs=false 
&listRecurse=false &listFiles=true 
&listFolders=true &listLinkInfo=true 
&listIncludeParent=true 
&listDerived=false &listBorders=false 
&listChildWebs=true &initialUrl= 
&platform=WinI386 &folderList=[;TW|09+Nov+2003+17:03:25+-0000]

L'exemple illustre la commande POST ainsi que la méthode, et dans ce cas, le chemin d'accès de la commande POST dirige la publication vers author.dll. Les points de suspension (...) représentent les lignes d'en-tête HTTP supprimées. La méthode et ses valeurs de paramètre suivent dans un format lisible.

Les sauts de ligne ont été ajoutés aux sections Décodée à des fins d'affichage dans les rubriques de méthode.

Pour plus d'informations sur le format dans lequel envoyer une commande POST, voir Syntaxe des méthodes.