exponenta event banner

matlab.net.QueryParameter класс

Пакет: matlab.net

Параметр в части запроса унифицированного идентификатора ресурса (URI)

Описание

Используйте QueryParameter для создания строки запроса URI формы:

name1=value1&name2=value2&name3=value3

где каждый name=value сегмент является QueryParameter объект, преобразованный в строку с помощью string способ. string метод на векторе QueryParameter объекты соединяют результаты с помощью & персонаж. string метод преобразует любые значения в строки и выполняет все необходимые кодировки специальных символов в результате.

Атрибуты класса

Sealed
true

Сведения об атрибутах класса см. в разделе Атрибуты класса.

Создание

Описание

obj = matlab.net.QueryParameter создает пустой параметр запроса.

obj = matlab.net.QueryParameter(paramName,paramValue) создает вектор параметра запроса paramName,paramValue аргументы пары. Можно указать несколько пар аргументов в любом порядке как paramName1,paramValue1,...,paramNameN,paramValueN.

пример

obj = matlab.net.QueryParameter(qStruct) создает вектор параметров запроса из структуры.

пример

obj = matlab.net.QueryParameter(queryStr) разборы queryStr в запрос.

obj = matlab.net.QueryParameter(___,Format) указывает формат, используемый для нескалярных значений, и может включать любой из входных аргументов в предыдущих синтаксисах.

Входные аргументы

развернуть все

Имя параметра, указанное как строка или символьный вектор.

Значение параметра, указанное как тип, требуемый paramName.

Имена и значения параметров, заданные как структура. Поля qStruct определите имена и значения параметров.

Типы данных: struct

Имена и значения параметров, заданные как строка или символьный вектор. queryStr является завершенным, закодированным запросом, как он будет отображаться в URI, с необязательным ведущим ? персонаж.

queryStr разделяется на & символы в отдельные name=value параметры запроса. Name свойство имеет значение name и Value свойство имеет значение value.

Триплет символов формы % и две шестнадцатеричные цифры представляют байт, закодированный в процентах. Последовательность этих байтов обрабатывается как UTF-8 кодированные символы, которые декодируются для формирования Name и Value свойства QueryParameters. Также любой знак «плюс» '+' в queryStr рассматривается как пробел '%20'. Когда QueryParameter преобразуется обратно в строку, любое требуемое процентное кодирование выполняется только для символов, которые должны быть закодированы. Это действие выполняется независимо от того, были ли эти символы первоначально закодированы в queryStr, так результат из string метод может не совсем совпадать queryStr. Смысл, однако, тот же при использовании в URI.

Например, кодировка UTF-8 для знака евро является E2 82 AC.

q1 = matlab.net.QueryParameter('V=%e2%82%ac')
q1 = 

  QueryParameter with properties:

      Name: "V"
     Value: "€"
    Format: csv

+ и %20 символы рассматриваются как пробелы.

q2 = matlab.net.QueryParameter('V=a+b%20c')
q2 = 

  QueryParameter with properties:

      Name: "V"
     Value: "a b c"
    Format: csv

string метод реализует процентную кодировку для символов, требующих кодировки. Например, кодируется.

string(q1)
ans = V=%E2%82%AC

Тем не менее, символы в queryStr аргумент 'V=a+b%20c' не нуждаются в кодировке.

q3 = string(q2)
q3 = V=a+b+c

Хотя результат от string метод не соответствует queryStr, значения идентичны при использовании в URI.

Свойства

развернуть все

Имя параметра, указанное как строка или символьный вектор.

Значение параметра, определенное как действительное число, логичное, дата и время (со стоимостью кроме NaT), последовательность, вектор характера, или вектор или вектор клетки этих ценностей. Если Value является любым другим типом, то Value должны поддерживать string или char методы, преобразующие значение в символьный вектор. Если пустое, Value обрабатывается как пустая строка.

Формат кодирования, указанный как matlab.net.ArrayFormat перечисление, для использования в кодировке Value если это вектор.

Методы

развернуть все

Примеры

свернуть все

Создание имени поля структуры this и установите его в значение that.

qStruct.this = 'that';
QP = matlab.net.QueryParameter(qStruct)
QP = 
  QueryParameter with properties:

      Name: "this"
     Value: 'that'
    Format: csv

Создайте символьный вектор с двумя запросами, this=that и one=2. QueryParameter разделение метода qStr на & символ в два QueryParameter объекты.

qStr = '?this=that&one=2';
QPs = matlab.net.QueryParameter(qStr);

name=value пары в qStr определить Name и Value свойства.

name1 = QPs(1).Name
name1 = 
"this"
value1 = QPs(1).Value
value1 = 
"that"
name2 = QPs(2).Name
name2 = 
"one"
value2 = QPs(2).Value
value2 = 
"2"
Представлен в R2016b