.NET 4.0 C#中如何构建HttpClient PostAsync的GraphQL请求内容？

针对你的场景，GraphQL API的POST请求体本质是一个包含query字段的JSON对象，下面提供两种适配.NET 4.0的实现方式：

方案一：直接构造JSON字符串（快速实现） #

这种方式无需定义额外类，适合参数固定或简单的场景：

1. 整理你的mutation字符串（用逐字字符串避免频繁转义）：

string mutation = @"mutation createAccounts {
    schema {
        insertJobs(input: {
            Name:   ""John Doe 10/09/2024"",
            ExternalID: ""52660"",
            Contacts: {
                FirstName: ""Sam & Sarah"",
                LastName:  ""Doe"",
                MobilePhone: ""555-333-4444"",
                DefaultContact: true,
                ExternalID: ""98765""
            }
        })
    }
}";

2. 包装成GraphQL要求的JSON结构，处理字符串中的特殊字符：

string jsonBody = $"{{\"query\": \"{EscapeGraphQLQuery(mutation)}\"}}";

// 辅助方法：转义JSON中的特殊字符
private static string EscapeGraphQLQuery(string query)
{
    return query.Replace("\"", "\\\"").Replace("\r\n", "\\n").Replace("\n", "\\n");
}

3. 创建HttpClient的Content并发送请求：

using (HttpClient client = new HttpClient())
{
    client.DefaultRequestHeaders.Authorization = new System.Net.Http.Headers.AuthenticationHeaderValue("Bearer", "你的令牌");
    
    StringContent content = new StringContent(jsonBody, Encoding.UTF8, "application/json");
    HttpResponseMessage response = await client.PostAsync("API地址", content);
    
    // 处理响应
    string responseBody = await response.Content.ReadAsStringAsync();
}

方案二：用类序列化生成JSON（规范可扩展） #

如果需要动态传入参数，建议定义类结构配合序列化器生成JSON，.NET 4.0常用两种序列化方式：

方式A：使用Newtonsoft.Json（Json.NET） #

先通过NuGet安装Newtonsoft.Json包（老项目中最常用的JSON库）：

1. 定义GraphQL请求类：

public class GraphQLRequest
{
    [JsonProperty("query")]
    public string Query { get; set; }
}

// 若需动态传参，可扩展为带变量的版本：
// public class GraphQLRequest<T>
// {
//     [JsonProperty("query")]
//     public string Query { get; set; }
//     [JsonProperty("variables")]
//     public T Variables { get; set; }
// }

2. 构造请求对象并序列化：

var graphQLRequest = new GraphQLRequest { Query = mutation };
string jsonBody = JsonConvert.SerializeObject(graphQLRequest);

3. 后续创建Content和发送请求的代码与方案一一致。

方式B：使用.NET自带的DataContractJsonSerializer #

无需额外安装包，但需要给类添加特性：

1. 定义带DataContract特性的类：

[DataContract]
public class GraphQLRequest
{
    [DataMember(Name = "query")]
    public string Query { get; set; }
}

2. 序列化对象：

var graphQLRequest = new GraphQLRequest { Query = mutation };
string jsonBody;

using (MemoryStream ms = new MemoryStream())
{
    DataContractJsonSerializer serializer = new DataContractJsonSerializer(typeof(GraphQLRequest));
    serializer.WriteObject(ms, graphQLRequest);
    jsonBody = Encoding.UTF8.GetString(ms.ToArray());
}

3. 同样创建StringContent并发送请求。

注意事项 #

• 确保请求头的Content-Type设置为application/json，这是GraphQL API的标准要求。
• 如果mutation需要动态参数（比如Name、ExternalID是变量），建议使用带Variables的GraphQLRequest类，将参数封装为对象，避免手动拼接字符串的风险。

内容的提问来源于stack exchange，提问作者Rene Abbott