replaceFields

类: matlab.net.http.Message
命名空间: matlab.net.http

在消息标头中更改值或添加字段

全页展开

语法

msg = replaceFields(msg,FieldName1,FieldValue1,...,FieldNameN,FieldValueN)
msg = replaceFields(msg,newFields)

说明

msg = replaceFields(msg,FieldName1,FieldValue1,...,FieldNameN,FieldValueN) 将具有指定名称的字段替换为 FieldName1,FieldValue1,...,FieldNameN,FieldValueN 中指定的值，并返回更新后的消息。

此方法与 changeFields 方法相同，但是，如果不存在与名称或类匹配的字段，则该方法会在标头末尾添加一个新字段，而不是抛出错误。

msg = replaceFields(msg,newFields) 将每条消息中的现有字段替换为 newFields 中指定的名称、值和类型，并返回更新后的消息。

输入参数

全部展开

消息，指定为 matlab.net.http.Message 对象。

由名称-值对组定义的字段。FieldName 指定为字符串或字符向量，FieldValue 指定为对 FieldName 有效的任何类型。

要使用此字段的默认值，请将 FieldValue 设置为 ''。

如果最后一个值缺失，则相当于指定空值 ([])。

要匹配的名称，指定为下列值之一。

  • 字符串向量、字符向量、字符向量元胞数组或以逗号分隔的字符串或字符向量列表，其中包含要替换的字段的名称。名称不区分大小写。

  • 向量或由一个或多个 HeaderField 对象组成的逗号分隔列表，这些对象的 Name 属性用于决定要替换的字段。名称不区分大小写。标头字段值将被忽略。

  • 向量或以逗号分隔的 matlab.metadata.Class 对象列表，这些对象是 HeaderField 的子类。

    replaceFields 方法将搜索与指定类支持的名称相匹配的名称，而不管是什么类。如果某个子类没有一组特定的受支持名称，将匹配该子类的所有标头字段，而不管其名称为何。调用 HeaderField.displaySubclasses 方法可查看支持的名称。

版本历史记录

在 R2016b 中推出

另请参阅

|