Référence de code Microsoft

Outils

Trouver des exemples de code

Utilisez microsoft_code_sample_search pour obtenir des exemples officiels et fonctionnels :

microsoft_code_sample_search(query: "upload file to blob storage", language: "csharp")
microsoft_code_sample_search(query: "authenticate with managed identity", language: "python")
microsoft_code_sample_search(query: "send message service bus", language: "javascript")

Quand l'utiliser :

• Avant d'écrire du code — trouvez un pattern fonctionnel à suivre
• Après des erreurs — comparez votre code avec un exemple fonctionnel connu
• Si vous êtes incertain sur l'initialisation/configuration — les exemples montrent le contexte complet

Lookups API

# Vérifier que la méthode existe (inclure le namespace pour la précision)
"BlobClient UploadAsync Azure.Storage.Blobs"
"GraphServiceClient Users Microsoft.Graph"

# Trouver une classe/interface
"DefaultAzureCredential class Azure.Identity"

# Trouver le bon package
"Azure Blob Storage NuGet package"
"azure-storage-blob pip package"

Récupérez la page complète quand la méthode a plusieurs surcharges ou que vous avez besoin des détails complets des paramètres.

Dépannage d'erreurs

Utilisez microsoft_code_sample_search pour trouver des exemples de code fonctionnels et les comparer avec votre implémentation. Pour des erreurs spécifiques, utilisez microsoft_docs_search et microsoft_docs_fetch :

Quand vérifier

Vérifiez toujours quand :

• Le nom de la méthode semble « trop facile » (UploadFile vs réel Upload)
• Vous mixez les versions du SDK (v11 CloudBlobClient vs v12 BlobServiceClient)
• Le nom du package ne suit pas les conventions (Azure.* pour .NET, azure-* pour Python)
• Vous utilisez une API pour la première fois

Workflow de validation

Avant de générer du code utilisant des SDK Microsoft, vérifiez qu'il est correct :

1. Confirmer que la méthode ou le package existe — microsoft_docs_search(query: "[ClassName] [MethodName] [Namespace]")
2. Récupérer les détails complets (pour les surcharges/params complexes) — microsoft_docs_fetch(url: "...")
3. Trouver un exemple fonctionnel — microsoft_code_sample_search(query: "[task]", language: "[lang]")

Pour les lookups simples, l'étape 1 seule peut suffire. Pour une utilisation API complexe, complétez les trois étapes.

Alternative CLI

Si le serveur Learn MCP n'est pas disponible, utilisez la CLI mslearn depuis un terminal ou shell (par exemple Bash, PowerShell ou cmd) à la place :

# Exécuter directement (pas d'installation requise)
npx @microsoft/learn-cli search "BlobClient UploadAsync Azure.Storage.Blobs"

# Ou installer globalement, puis exécuter
npm install -g @microsoft/learn-cli
mslearn search "BlobClient UploadAsync Azure.Storage.Blobs"

Passez --json à search ou code-search pour obtenir une sortie JSON brute à traiter ultérieurement.